api-design - Design consistent, production-grade APIs
Design REST, GraphQL, gRPC, and WebSocket APIs with consistent schemas, versioning, error standards, pagination, and developer experience.
Tags
Updated: 2026-09-30Typical Inputs
What this skill does
- Design REST APIs
- Design GraphQL schemas
- Design gRPC contracts
- Design WebSocket APIs
- Choose API styles
- Define endpoint structures
- Structure request responses
- Standardize API errors
- Design pagination patterns
- Plan API versioning
- Produce OpenAPI specifications
Inputs
- Caller information
- Domain resources
- Resource operations
- Read-write patterns
- Latency constraints
- Payload size constraints
- Versioning requirements
Outputs
- API endpoint definitions
- Request response schemas
- GraphQL schemas
- Protocol buffer files
- OpenAPI specifications
- Error response standards
- Pagination specifications
- Versioning strategies