Define HTTP API contracts with semantic status codes and resource-oriented naming.
npx skills add https://github.com/espensev/ai-skills --skill api-design-espensev
Please help me install this Agent Skill. Skill: api-design Source: https://github.com/espensev/ai-skills/tree/main/codex-skills/skills/api-design Command: npx skills add https://github.com/espensev/ai-skills --skill api-design-espensev
Establishing consistent API surfaces that are easy to understand, implement, test, and evolve across a codebase.
Draft a new endpoint contract by detailing the resource, allowed methods, status codes, and response structure.
High-intent search queries and answers about installing and using this skill.
To design REST APIs that scale, define resources with plural naming and clear ownership, then apply standard rules for endpoints, semantic status codes, and stable response structures across services. This consistency makes APIs easier to test and evolve.
The best way to structure API versioning and authentication is to separate security considerations and apply consistent versioning rules across your endpoints. This approach ensures durable APIs by maintaining clear contracts while the underlying services evolve.
To standardize error handling and pagination in an API contract, apply design rules that enforce repository conventions for error responses and pagination structures. This improves client reliability by providing predictable and clear resource contracts.
Yes, you can use this API design approach to review existing APIs and guide refactors for consistency. By checking current endpoints against rules for resource-oriented naming and response structures, you can establish a more consistent API surface.
When drafting a new HTTP API endpoint contract, you should detail the resource, allowed methods, semantic status codes, and response structure. Defining these elements establishes a clear contract that is easy to implement and test.
vrcmsStandardizes Laravel app architecture by separating HTTP layers, services, and Eloquent models.
navraj007inConvert blueprint API specifications into downloadable OpenAPI 3.0 documents.
mahg-esDesign and configure API gateways for routing, authentication, and traffic management.
duylinhdang1998Design and implement type-safe GraphQL APIs with DataLoader batching and Relay pagination.
