Design clear, scalable REST and GraphQL APIs including resource modeling, HTTP methods, pagination, error handling, versioning, and schema best practices.
Initial release of API Design Principles skill. - Comprehensive guide for designing intuitive REST and GraphQL APIs, covering resource modeling, HTTP semantics, pagination, error handling, and versioning. - Includes decision framework for choosing between REST and GraphQL. - Provides clear examples and conventions for endpoint naming, filtering, sorting, status codes, and error response structures. - Offers ready-to-use FastAPI and GraphQL schema patterns, with practical implementation tips and code samples. - Covers API versioning and deprecation strategies, supporting both URL and header-based approaches.