本页目录

API故障排查

调用方先保存请求时间、方法、路径、HTTP 状态和响应中的 requestId 或错误码，再根据响应判断重试方式。

调用方提交排查材料时，需要移除认证头、API Key、Cookie、完整文件和无关业务正文。

按返回现象定位

现象	先检查	下一步
无响应或 TLS 失败	DNS、正式入口、证书、网络和代理	从调用方网络检查；不要改为跳过证书校验长期运行
401	凭证是否过期、撤销或类型不匹配	由凭证持有人重新认证，不复制他人令牌
403	License、scope、执行身份、资源与数字员工权限	根据响应与管理员日志确定原因，不统一归结为登录失败
404	服务端版本、路径、资源是否存在或对当前身份可见	使用目标版本契约；不要按旧页面猜接口
429	调用频率、并发与返回的重试信息	按服务约定退避，不持续密集重放
5xx	请求关联信息、服务与依赖状态	保留 requestId 交管理员定位，确认副作用后再重试

相同 HTTP 状态可能来自前置网关、产品 API、数字员工运行时或外部模型。调用方需要结合响应和关联日志定位出错层级，各服务的业务错误码以对应版本契约为准。

调用方在消息发送、文件写入、任务执行或业务插件操作失败后，先检查原请求是否已产生结果。请求超时后，服务仍可能完成执行。

调用方按目标接口契约使用幂等标识和重试方式，不自行添加未经支持的请求头或重复创建任务。

调用方按反馈材料整理服务端与客户端版本、脱敏路径和参数结构、时间与时区、状态码、已有的关联标识、预期结果和实际结果，再通过联系支持渠道提交。