API 错误码规范与诊断清单（2025）

统一错误码与诊断流程让跨团队协作更高效。

一、结构与分类

• 结构：code/message/traceId/details。
• 分类：客户端/服务端/依赖错误细分与范围编码。

二、诊断与重试

• 诊断清单：必采集字段与上下文、用户影响与复现路径。
• 重试与退避：按错误类别设定可重试策略。

三、观测与告警

• 观测：错误率与分布与热点接口。
• 告警：阈值触发与分级响应与路由到责任团队。

注意事项

• 分类、关键词与描述与正文一致；与契约与文档平台统一。