C 站链接配置查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @user_ac9585d3/platform-csite-website-docking-by-token
技能介绍
要解决的问题
在 kutesmart 海外运营平台的 C 站(content site)场景中,运营人员通常持有一个用于标识某条链接配置的 token,需要据此获取该配置对应的完整 URL、跳转目标、生效状态等字段。前端页面、工单系统或自动化脚本自行拼装查询逻辑,不仅会重复实现鉴权、URL 模板和错误处理,还容易在 token 过期、租户切换或网关迁移时出现行为不一致。这个技能把「通过 token 查询 C 网站链接配置」收敛为一个原子动作,让调用方无需关心接口地址、请求格式和权限头如何组装。
它做了什么
技能只暴露一个 action:docking_by_token,对应一次 GET 请求:
- 请求方法:
GET - 请求路径:
/docking/public/c/getByToken - 正式环境 base_url 固定为
https://www.kutetailor.com/api/fabric/docking/public,来自 frontmatter,不接受用户输入覆盖 - 唯一必传参数:
params.query.token,即调用方持有的链接配置令牌
调用时,工具参数统一放在嵌套的 params 对象中,而不是用 params.xxx 的点号 key。登录态通过 params.accessToken 传入,技能会自动拼接为 Authorization: Bearer;如果传入值已经包含 Bearer,则不会重复拼接。
返回结果以接口响应为事实来源,上层 agent 可以直接消费 RS 中的字段。如果遇到认证失败、权限不足、参数错误或业务异常,技能会把原始错误码和错误信息原样上抛,方便上层根据具体错误码决定重试、刷新令牌还是提示人工介入。
适用边界
这是最小颗粒度的接口技能,不是业务流程编排器。它只完成「一次 token 查询」这一接口动作。如果用户需求涉及多个接口步骤——例如先校验 token 有效性,再拉取配置,再更新状态——应由上层 agent 通过聚合 skill(如 platform-csite-website)或计划文档来编排多个原子 skill,而不是在这个技能内部展开。
另外需要注意:该接口属于查询或计算类操作,但仍然受当前登录态、租户和用户权限约束。调用方传入的 token 必须与当前登录用户的租户上下文匹配,否则可能返回权限错误而非空结果。技能不会补造库存、价格、订单号、优惠金额或物流状态等业务字段,所有展示层数据都应以接口返回为准。
使用场景
- 运营人员在配置 C 站外链时,需根据业务方提供的 token 快速验证链接跳转目标与生效状态是否匹配。
- 自动化脚本在生成 C 站落地页时,需调用接口将已知的 token 换取为实际 URL 以便写入页面配置。
- 技术支持在排查链接失效问题时,通过传入 token 查询接口返回的配置详情与错误码来快速定位原因。
- 上层 Agent 在编排 C 站发布流程时,需先调用此接口获取配置信息,再将关键字段交给后续步骤处理。
适合人员
- 负责 C 站内容配置与链接维护的运营专员,需要在变更配置后立即确认线上跳转是否符合预期。
- 开发内部管理后台或自动化工具的工程师,需要将 token 转 URL 的逻辑封装为可复用的接口调用。
- 构建内容发布自动化链路的 Agent 开发者,需要获取一个稳定的原子接口来串联配置校验与发布步骤。
- 处理 C 站链接故障的技术支持人员,需要快速查询特定 token 对应的配置状态及权限是否异常。