API Design Skill

This skill provides comprehensive guidance for designing RESTful APIs following industry best practices.

Core Principles

1. Resource-Oriented Design

• Use nouns for resource names (e.g., /users, /products)
• Avoid verbs in URLs
• Use HTTP methods to represent actions

2. HTTP Methods

• GET: Retrieve resources
• POST: Create new resources
• PUT: Update entire resources
• PATCH: Partial updates
• DELETE: Remove resources

3. URL Structure