常见对接问题
认证相关
Q: Token 获取失败,返回 401 错误
请检查以下几点:
- 确认
wyxdkey和app_secret是否正确 - 确认是否使用了正确的环境(沙箱/生产)
- 确认密钥是否已过期或被重置
Q: Token 过期后请求返回 403
Token 有效期为 2 小时,过期后需重新获取。建议在应用中实现 Token 自动刷新机制。
接口调用相关
Q: 请求返回"签名验证失败"
请确认请求参数的排序和编码方式是否符合签名规则,详见「认证鉴权机制」文档。
Q: 接口返回数据为空
可能原因:
- 查询条件过于严格,尝试放宽筛选条件
- 沙箱环境数据有限,建议先导入测试数据
- 确认账号权限是否包含该接口的访问权限
回调通知相关
Q: 收不到订单状态回调
请检查:
- 回调地址是否配置正确且可公网访问
- 服务器防火墙是否放行了平台 IP
- 回调接口是否正确返回了 200 状态码
