SuperAPI AI 工具集

api-implementation

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:在拿到 OpenAPI 契约后,按统一分层规范实现后端端点,适用于多语言、多框架的接口落地与联调。

主要能力:一是跨框架范式参考,给出 Spring Boot、NestJS、Django(DRF)、FastAPI、Go(Gin)、Express/Fastify 等请求解析、DTO 校验、Service 编排、Repository 访问、全局异常处理的写法;二是分层约束,Controller 只接收请求、校验并调用 Service,Service 负责业务规则与事务边界,Repository 隐藏 ORM/SQL,Domain Model 承载业务不变量;三是横切关注点清单,含认证、鉴权、请求 ID、访问日志、全局异常、请求体校验、限流、CORS,按需补充缓存、压缩、安全头、国际化、审计日志。

使用方式:先读 OpenAPI 契约,选定技术栈与分层规范,依次创建请求/响应 DTO、薄 Controller、Service、Repository,再接入全局错误处理器,最后补单元测试与集成测试。资料内配套模板为 templates/api-implementation-checklist.md。

限制与注意:错误码需与契约一致,HTTP 状态语义要正确(POST 返回 201、DELETE 返回 204);避免 Controller 写业务、DTO 与 Entity 共用、每个端点单独做错误处理、Controller 直接调多个 Repository 等常见问题;校验不应只放 Controller。与 api-designer、domain-modeling、data-access、auth-implementation、testing-implementation、observability 等相关技能协作。具体命令、安装方式与收费信息资料未提供。