常见问题

FAQ

有 AppID/AppKey，为什么仍然调用失败？

凭证只用于身份校验。还需申请目标 API 权限，并确保已购买套餐、额度充足；企业专用 API 还可能要求企业认证或企业账号。

签名总是失败怎么办？

确认拼接顺序为 appId + timestamp + appKey，没有分隔符；时间戳是 13 位毫秒值且在 2 分钟内；MD5 输出是 32 位小写；请求使用的是当前有效密钥。

在线测试成功，本地调用失败怎么办？

逐项比对在线测试生成的 URL、请求方式、Headers、Content-Type、JSON 结构、编码、时间戳生成方式和服务器出口 IP。

额度为什么没有增加？

额度按 API 隔离，不能跨接口转移。检查是否购买了同一个 API、订单是否成功、套餐是否已生效以及统计页面的时间范围。

是否可以在前端直接调用？

不建议。前端会暴露 AppKey，导致他人伪造请求。应由自有服务端保存密钥并代理调用。

偶发超时如何处理？

设置连接/读取超时，记录耗时和请求 ID，对可安全重试的场景使用有限次数指数退避；涉及扣费或写入的请求先确认幂等策略。