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

# API 错误码规范与诊断清单（2025） 统一错误码与诊断流程让跨团队协作更高效。 ## 一、结构与分类 - 结构：`code`/`message`/`traceId`/`details`。 - 分类：客户端/服务端/依赖错误细分与范围编码。 ## 二、诊断与重试 - 诊断清单：必采集字段与上下文、用户影响与复现路径。 - 重试与退避：按错误类别设定可重试策略。 ## 三、观测与告警 - 观测：错误率与分布与热点接口。 - 告警：阈值触发与分级响应与路由到责任团队。 ## 注意事项 - 分类、关键词与描述与正文一致；与契约与文档平台统一。