错误码

通用规则

接口优先使用 HTTP 200 返回业务结果,并通过 JSON codemessagesuggestion 表达业务状态。

调用方应展示可恢复建议,不应把错误信息扩写成接口未返回的承诺。

常见状态

0     成功
400   参数缺失或格式错误
404   目标资源不存在或不可展示
429   调用过快或触发限流
500   服务端异常

调用方处理建议

  • 参数缺失:提示用户补充出发地、目的地、日期或群 ID。
  • 无查询结果:可调用 recommendNextAction 获取发布需求草稿和相关官方群入口。
  • 限流:降低重试频率,避免连续探测同一路线或同一工具。
  • 服务异常:提示稍后再试,不编造替代结果。