【研发类-架构设计Skills】api-patterns 技能

发布时间:2026/7/19 21:11:46

【研发类-架构设计Skills】api-patterns 技能 API设计原则和决策制定。REST vs GraphQL vs tRPC选择、响应格式、版本控制、分页。技能概述api-patterns 技能专注于API设计原则和决策制定帮助开发者学会思考而非复制固定模式。适用于2025年的现代API开发。下载地址agentic-awesome-skills/skills/api-patterns at main · sickn33/agentic-awesome-skills · GitHub内容地图文件描述何时阅读api-style.mdREST vs GraphQL vs tRPC决策树选择API类型rest.md资源命名、HTTP方法、状态码设计REST APIresponse.md信封模式、错误格式、分页响应结构graphql.md架构设计、何时使用、安全考虑GraphQLtrpc.mdTypeScript单体仓库、类型安全TS全栈项目versioning.mdURI/Header/查询版本控制API演进规划auth.mdJWT、OAuth、Passkey、API密钥认证模式选择rate-limiting.md令牌桶、滑动窗口API保护documentation.mdOpenAPI/Swagger最佳实践文档security-testing.mdOWASP API Top 10、认证/授权测试安全审计决策检查清单询问用户关于API消费者为此上下文选择API风格REST/GraphQL/tRPC定义一致的响应格式规划版本控制策略考虑认证需求规划速率限制定义文档方法反模式不要默认所有情况都使用REST在REST端点中使用动词/getUsers返回不一致的响应格式向客户端暴露内部错误跳过速率限制要根据上下文选择API风格询问客户端需求彻底文档化使用适当的状态码使用限制仅当任务明确匹配上述范围时使用此技能不要将输出替代环境特定的验证、测试或专家审查如果缺少必需的输入、权限、安全边界或成功标准请停止并请求澄清

相关新闻