接入测试与常见问题

如何快速导入调试

1. 获取调试 DEMO 包（可联系服务人员）
2. 将 DEMO 包导入接口调试工具（推荐 apipost）
3. 将请求地址改为测试环境请求地址
4. 在测试环境上调通接口
5. 将正式密钥配置到程序中，并将请求地址改为正式环境请求地址后即可上线

参数转码无效的解决方案

现象：接口报参数无效，多与中文参数有关。

排查顺序：

1. 首先检查配置中的参数是否与系统上提供的参数一致，是否包含中文

2. 处理中文转码问题，有两个需要正确转码的环节：

环节	要求
中文参数传入生成 URL 的方法时	注意编码问题
生成请求参数后	中文值不能是乱码，仅支持 UTF-8 编码格式

错误响应格式

所有接口失败时返回（注意 HTTP 200 下以 message 区分失败原因）：

{
  "code": 200,
  "message": "无权限访问"
}

常见失败原因：

message	可能原因
无权限访问	key/secret 错误；或应用未勾选对应接口的权限
token 失效类提示	token 过期，重新调用鉴权接口
频率限制	请求间隔小于应用设置的访问间隔，请退避重试

结语

感谢您选择 ATECLOUD！我们将持续优化 API 性能与功能，致力于为开发者提供稳定、易用、安全的集成体验。如在使用过程中遇到任何问题，或对文档有任何建议，欢迎随时与我们联系。

—— ATECLOUD 开发者团队 · 文档最后更新：2025-10-29