SuperAPI AI 工具集

error-contract

编程与开发

查看项目

更新于 10-15 18:51

技能介绍

用途:定义并校验前后端统一的错误响应契约,覆盖错误结构、HTTP 状态码映射与一致的错误处理。

主要能力:提供 RFC 7807(Problem Details)与简化错误结构两种标准响应格式;给出 OpenAPI 错误定义示例(Error、ErrorDetail、BadRequest/Unauthorized/NotFound 响应);提供状态码映射表(400 VALIDATION_ERROR、401 UNAUTHORIZED、403 FORBIDDEN、404 NOT_FOUND、409 CONFLICT、422 UNPROCESSABLE_ENTITY、429 TOO_MANY_REQUESTS、500 INTERNAL_ERROR、503 SERVICE_UNAVAILABLE);包含前端 TypeScript 错误类型与 ApiRequestError、fetch 封装、React Error Boundary、React Query 重试与全局错误处理,以及 NestJS 异常过滤器、Spring Boot 全局异常处理示例;附校验报告模板与反模式清单。

使用方式:作为开发参考,按项目需要选用标准错误结构,并让前后端遵循同一 schema 与状态码约定;可结合校验报告模板逐项核对字段、状态码处理与建议。

适用场景:设计或评审 REST API 错误格式、统一前后端错误解析、编写表单字段级校验错误展示、排查错误未被正确解析的问题。

限制:不适用于日志配置、语言级异常处理模式与安全错误处理(应使用相应技能);框架深度细节需通过 mcp__documentation__fetch_docs 查询。收费、价格与具体平台支持情况暂未提供。