REST API Designer
Design clean, consistent RESTful APIs following industry best practices for resource naming and HTTP semantics.
Usage
Describe the resources and operations your API needs and this skill will design the endpoints and data contracts.
Examples
- "Design a REST API for a blog platform with posts, comments, and tags"
- "Create API endpoints for a user management system with roles"
- "Design a RESTful API for an inventory management system"
Guidelines
- Use plural nouns for resource names, not verbs
- Return appropriate HTTP status codes for each response type
- Implement consistent pagination with cursor or offset patterns
- Version your API from the start using URL or header versioning
- Include HATEOAS links for discoverability when appropriate