api-designer

REST API design involves defining resources as nouns, mapping them to URL structures, and using HTTP methods (GET, POST, PUT, DELETE) semantically. This Skill provides best practices for resource orientation, endpoint design, payload schemas, and pagination to ensure scalable, developer-friendly APIs.

OpenAPI 3.0 specifications document API contracts with executable detail. This Skill generates and validates OpenAPI specs from your API design, producing interactive documentation and enabling client code generation, ensuring consistency across teams and reducing integration errors.

API security requires choosing an authentication pattern—OAuth 2.0, JWT, or API keys—and designing authorization strategies. This Skill covers implementation patterns, best practices, and trade-offs for each approach, helping you protect endpoints and manage user permissions correctly.

API versioning prevents breaking changes for existing clients. This Skill covers versioning strategies like URL-based, header-based, and semantic versioning approaches for both REST and GraphQL, helping you maintain backward compatibility while adding features.

Yes. This Skill covers both REST and GraphQL API design. For GraphQL, it addresses schema design, query structure, authorization patterns, and documentation generation, enabling you to choose the architecture that fits your use case.

Consistent error handling improves API usability. This Skill documents HTTP status code semantics, error response formats, and exception patterns for both REST and GraphQL, reducing client-side confusion and supporting debugging.