api-design

REST API resource naming requires establishing clear conventions for URL structures and resource identification. This Skill provides comprehensive guidelines to ensure your endpoints are consistent, maintainable, and reduce integration friction for developers.

HTTP status codes in REST APIs must semantically match the operation outcome, differentiating between success, client errors, and server faults. This Skill details appropriate status codes for various scenarios alongside the correct semantic use of HTTP methods.

Implementing pagination, filtering, and sorting in a REST API requires specific strategies to handle large datasets efficiently without overwhelming the client. This Skill offers established patterns to retrieve and manage subsets of data effectively.

Error responses and API versioning in web services are best handled by creating informative error payloads and managing API evolution systematically. This Skill guides you through establishing robust error handling and versioning conventions.

These API design patterns are fully compatible with TypeScript, Python, and Go backends. The Skill provides implementation patterns and conventions for URL structures and response envelopes across these specific languages.

Rate limiting and authentication are needed for production-ready REST APIs to control traffic flow and secure access to resources. This Skill covers these implementation patterns to ensure your web services are robust and scalable.