api-design - REST API Design Patterns and Best Practices
Apply REST API design patterns including resource naming, status codes, pagination, filtering, and error responses for production APIs.
Tags
Updated: 2026-03-26Capabilities
Typical Inputs
Typical Outputs
What this skill does
- design API endpoints
- review API contracts
- define HTTP methods
- assign status codes
- implement pagination
- add filtering
- add sorting
- structure error responses
- configure rate limiting
- plan API versioning
Inputs
- API requirements
- resource data model
- business logic
- use case specification
- authentication configuration
Outputs
- API endpoint definitions
- HTTP method specifications
- status code mappings
- request/response schemas
- pagination configuration
- error response structures
- rate limiting policies
Requirements
- HTTP protocol knowledge
- RESTful architecture understanding
- JSON data handling