美洽 2026 版发布,AI 客服助手全量开放立即了解

接口报错

按错误码定位鉴权、参数与限流

调用开放接口报错时,先看返回的错误码:鉴权、参数与限流是最常见的三类原因。多数问题无需提工单即可自行解决。

鉴权类错误

检查密钥是否正确、是否过期,以及请求签名的时间戳与算法是否匹配。

  • 确认使用正确的密钥
  • 检查签名算法与时间戳
  • 确认接口权限范围

参数类错误

核对必填字段、字段类型与枚举值,分页参数超出范围也会返回错误。

  • 核对必填字段
  • 检查字段类型与枚举
  • 分页大小不超过上限

限流与重试

触发限流时应按指数退避重试,避免短时间大量重发导致持续失败。

  • 按指数退避重试
  • 错峰批量任务
  • 在控制台查看用量

常见问题

返回签名错误但密钥正确?

多为时间戳偏差或参数排序不一致,请对照文档重新生成签名。

Webhook 收不到事件?

检查回调地址是否可公网访问、是否校验签名失败,并查看失败重试日志。

让每一次对话都有回应

接入美洽,把网站、App、微信与邮件的客户咨询汇聚到一个工作台。

免费试用