常见对接问题

网约向导技术团队发布于 2026-03-10更新于 2026-05-01

认证相关

Q: Token 获取失败,返回 401 错误

请检查以下几点:

  • 确认 wyxdkeyapp_secret 是否正确
  • 确认是否使用了正确的环境(沙箱/生产)
  • 确认密钥是否已过期或被重置

Q: Token 过期后请求返回 403

Token 有效期为 2 小时,过期后需重新获取。建议在应用中实现 Token 自动刷新机制。

接口调用相关

Q: 请求返回"签名验证失败"

请确认请求参数的排序和编码方式是否符合签名规则,详见「认证鉴权机制」文档。

Q: 接口返回数据为空

可能原因:

  • 查询条件过于严格,尝试放宽筛选条件
  • 沙箱环境数据有限,建议先导入测试数据
  • 确认账号权限是否包含该接口的访问权限

回调通知相关

Q: 收不到订单状态回调

请检查:

  1. 回调地址是否配置正确且可公网访问
  2. 服务器防火墙是否放行了平台 IP
  3. 回调接口是否正确返回了 200 状态码