调用开放接口报错时,先看返回的错误码:鉴权、参数与限流是最常见的三类原因。多数问题无需提工单即可自行解决。
鉴权类错误
检查密钥是否正确、是否过期,以及请求签名的时间戳与算法是否匹配。
- 确认使用正确的密钥
- 检查签名算法与时间戳
- 确认接口权限范围
参数类错误
核对必填字段、字段类型与枚举值,分页参数超出范围也会返回错误。
- 核对必填字段
- 检查字段类型与枚举
- 分页大小不超过上限
限流与重试
触发限流时应按指数退避重试,避免短时间大量重发导致持续失败。
- 按指数退避重试
- 错峰批量任务
- 在控制台查看用量
常见问题
返回签名错误但密钥正确?
多为时间戳偏差或参数排序不一致,请对照文档重新生成签名。
Webhook 收不到事件?
检查回调地址是否可公网访问、是否校验签名失败,并查看失败重试日志。