⚡

API错误分类 api-error-taxonomy

该技能用于定义和标准化API错误代码及响应，帮助开发人员实现一致的错误处理，提升系统可维护性和用户体验。关键词：API错误、错误分类、标准化、错误处理、后端开发、API设计、错误响应、HTTP状态码、重试策略、日志记录。

后端开发 0 次安装 0 次浏览 更新于 3/7/2026

name: api-error-taxonomy description: 定义一致的API错误代码和响应。当中级开发人员需要错误标准化时使用。

API 错误分类

目的

定义一致的API错误代码和响应。

请求输入

  • 当前错误响应和状态使用情况。
  • 客户端对重试和消息传递的期望。
  • 日志记录和可观测性要求。

工作流程

  1. 列出常见错误类别和HTTP映射。
  2. 定义错误有效负载形状和字段。
  3. 设置日志记录和客户端消息传递的指南。

输出

  • 错误分类表和示例。

质量标准

  • 确保错误是机器可解析的。
  • 对齐可重试与非可重试的语义。