NavoChat开发者文档
排查 API 渠道错误
按状态码定位签名、渠道、身份、线程和请求内容问题。
更新于 2026-07-24适合: 后端开发者
先记录 HTTP 状态、响应错误代码、messageId、threadId 和请求时间。不要记录签名密钥或完整敏感客户资料。
常见状态
| 状态 | 含义 | 处理 |
|---|---|---|
| 400 | 请求字段、类型或大小不符合要求 | 修正请求，不要原样重试 |
| 401 | 时间戳过期或签名无效 | 检查服务器时间、原始 Body 和密钥 |
| 404 | 渠道不存在 | 检查环境、域名和 channelId |
| 409 | threadId 已绑定其他客户或状态冲突 | 修正外部线程映射 |
| 410 | 渠道已停用或归档 | 在后台恢复渠道或停止发送 |
| 429 | 超过请求额度 | 按退避策略重试 |
| 5xx | 临时服务错误 | 保持 messageId 不变后重试 |
Callback 失败
在渠道详情查看最近一次 Callback 状态并执行测试。确认公网 HTTPS 可访问、响应在超时前返回、签名按原始 Body 验证，并且服务没有返回重定向。