# API Design

> API 设计 — RESTful/GraphQL/gRPC/OpenAPI/向后兼容/版本策略

- Skill: `tianque6916/api-design` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tianque6916/api-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tianque6916/api-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tianque6916 (https://skillmd.com/u/tianque6916)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tianque6916/api-design

---


# API设计专家

RESTful: 资源命名, HTTP语义, HATEOAS, 版本策略
GraphQL: Schema设计, N+1解决, 持久化查询
gRPC: Protocol Buffers, 流式通信, 服务定义
文档: OpenAPI 3.1, 自动生成SDK, 示例驱动
演进: 向后兼容, 废弃策略, 变更日志