requestId、接口路径、请求时间和业务错误码。不要记录或提交 APP_SECRET、Token、完整签名字符串和敏感内容。
Token 与鉴权
获取 Token 返回 10108
现象： HTTP 200，success=false，code=10108。检查： 使用毫秒时间戳；加入固定
sign_ver=1.0 和 app_secret；按键名升序；采用 RFC1738 编码；计算 32 位小写 MD5。重试： 修正签名后重试，不能原样重试。可用兼容性测试向量验证本地实现。
Token 获取成功，但业务接口返回 10103 或 10104
检查： Token 必须放在X-Legacy-Token 请求头，不要放 URL、JSON body 或 Authorization。10104 时重新获取 Token。重试： 只在请求头修正或 Token 更新后重试。
返回 10020 或 1003
检查： Token 是否来自正确应用；当前应用是否拥有目标接口与资源权限；资源是否由同一应用创建。重试： 相同凭据和资源 ID 不应重复重试。
请求与响应
HTTP 200，但 success=false
这是结构化业务错误。读取code 与 message，按常见错误码处理。HTTP 200 不代表业务成功。
返回 2000、2100 或 2200
2000 表示 HTTP 方法不正确，2100 表示路径不存在，2200 表示接口已停用。以 API 参考页显示的方法和路径为准；接口停用时停止调用。
返回 10001 请求频率过高
采用指数退避和随机抖动，减少并发和无间隔轮询。限额可能由环境配置决定，不要把某个观察值写死为永久阈值。智能任务
任务长时间停留在 0 或 2
保留task_id 并继续退避轮询，不要重复创建。达到你的业务等待上限后，提供任务 ID、最近一次 requestId 和请求时间联系支持。
任务查询 success=true，但 status=-1
查询接口执行成功，但任务本身失败。停止轮询，读取error_message。修正素材、参数或内容后创建新任务。
创建请求超时，不知道任务是否创建
这是结果不确定状态。先查应用内已有任务；无法确认时提供请求时间和追踪信息联系支持，不要自动无限重放创建请求。海外社媒
素材 URL 校验通过，但发布仍失败
确认素材可从公网直接访问，没有登录、Cookie、防盗链、临时内网地址或过短有效期；再检查目标平台对格式和内容的限制。发帖已提交，但平台暂时不可见
使用发帖响应中的social_post_id 查询帖子详情。queued、submitting、accepted、processing、retrying 都不是终态；不要重复发帖。
帖子或评论接口返回 404
检查传入的是平台本地资源 ID，并确认资源属于当前应用。帖子详情和评论接口的post_id 应使用发帖响应中的 social_post_id，不要传 action_sn 或第三方平台 ID。
评论同步没有结果
保存同步响应的action_sn，只在明确接收该字段的评论同步状态接口中查询。若状态失败，保留 error_message 和 requestId。
大模型对话
401 invalid_api_key：确认服务端读取的是当前启用应用的 APP_SECRET，且请求头为Authorization: Bearer ...。400 invalid_request_error：检查model是否来自模型目录，以及当前模型是否支持所用参数或 Responses API。400 insufficient_balance：补充应用所属账户余额后重试。- 流式没有内容：确认客户端持续读取
text/event-stream，没有等待整个响应后再解析 JSON。 - 不要为了绕过跨域把 APP_SECRET 放进浏览器；对话接口仅设计为服务端调用。
Webhook
- 重复投递：确认响应不是 204 或空体，并且 JSON 为
{"success":true,"code":200}。 - 验签失败：Webhook timestamp 是秒级；签名原文包含事件 ID、一个换行符和请求头时间戳。
- 偶发重复：属于至少一次投递的正常情况，应按
event_id幂等。 - 经常超时：把耗时业务移到本地异步队列，6 秒内只完成验签、落库和确认。
- 完全收不到：确认控制台保存了公网可访问的回调地址，且网络层允许平台发起 POST。
浏览器跨域
若浏览器报告 CORS 错误：- 确认页面 Origin 的协议、域名和端口与允许值完全一致。
- 确认请求头只有接口允许的字段，并使用正确的 API 域名。
- 浏览器预检失败时查看
OPTIONS请求，而不是只看业务请求。 - 生产接入优先从你的服务端调用 API，避免在浏览器中暴露业务 Token。
联系支持时提供
requestId- 请求时间与时区
- HTTP 方法和路径
- HTTP 状态、业务
code、message task_id、social_account_id、本地post_id或comment_id中与问题相关的标识- 已做过的排查步骤