错误码
通用规则
接口优先使用 HTTP 200 返回业务结果,并通过 JSON code、message、suggestion 表达业务状态。
调用方应展示可恢复建议,不应把错误信息扩写成接口未返回的承诺。
常见状态
0 成功
400 参数缺失或格式错误
404 目标资源不存在或不可展示
429 调用过快或触发限流
500 服务端异常
调用方处理建议
- 参数缺失:提示用户补充出发地、目的地、日期或群 ID。
- 无查询结果:可调用
recommendNextAction获取发布需求草稿和相关官方群入口。 - 限流:降低重试频率,避免连续探测同一路线或同一工具。
- 服务异常:提示稍后再试,不编造替代结果。