用途:该技能聚焦 REST 与 GraphQL API 设计原则,用于设计新接口、重构既有 API、建立团队设计标准、在实现前评审 API 规格、在 REST 与 GraphQL 之间迁移、编写开发者友好文档,以及针对移动端或第三方集成优化 API。
主要能力:REST 部分涵盖面向资源的架构(资源用名词、HTTP 方法表达动作、URL 表示层级、命名一致)、HTTP 方法语义(GET 幂等安全、POST 创建、PUT 整体替换、PATCH 局部更新、DELETE 删除)、版本化策略(URL、请求头、查询参数)、分页与过滤、统一错误响应与状态码、HATEOAS。GraphQL 部分涵盖 schema 优先开发、类型/查询/变更/订阅、Relay 风格游标分页、解析器设计、DataLoader 防止 N+1、结构化错误返回。
使用方式:资料提供 REST 与 GraphQL 的代码示例与模板,包括 FastAPI 分页与错误处理示例、GraphQL schema 与解析器示例、DataLoader 批处理示例,以及参考文档、模板与 OpenAPI 生成脚本等资源。
适用场景:新 API 设计、API 重构、团队规范制定、规格评审、范式迁移、文档编写与特定场景优化。
限制:资料未提供安装命令、收费方式、平台支持或效果数据,这些信息暂未提供。