API Design Patterns

When to use this skill

• Designing new API endpoints.
• Documenting APIs (OpenAPI/Swagger).
• Implementing authentication strategies.

1. RESTful Conventions

• Nouns: Use nouns for resources (/users, not /getUsers).
• Verbs: Use correct HTTP methods (GET read, POST create, PUT replace, PATCH update, DELETE remove).
• Status Codes: 200 OK, 201 Created, 400 Bad Request, 401 Unauth, 403 Forbidden, 404 Not Found, 422 Validation Error.