designing-web-apis

Best practices for Web API design covering endpoints, responses, HTTP spec usage, versioning, and security. Use this when designing REST-style HTTP APIs or adding new endpoints. For framework-specific implementations (Express, NestJS), use the respective framework skill; for microservices patterns, use architecting-microservices. For API usability vs. maintenance trade-off analysis, use analyzing-software-tradeoffs. For spec-first development methodology and end-to-end test frameworks, use developing-api-spec-first.