How does it handle API versioning?

It recommends URL path versioning (e.g., /v1/) and provides a clear strategy for managing breaking changes, deprecation notices, and sunsetting old versions.

How does this skill improve API consistency?

It enforces strict naming conventions (like kebab-case for URLs) and standardized response structures (data wrappers), ensuring every endpoint behaves predictably for developers.

Does it support modern pagination techniques?

Yes, it provides implementation patterns for both simple Offset pagination and high-performance Cursor-based pagination for large datasets.

What languages are covered in the implementation examples?

The skill includes production-ready code patterns for TypeScript (Next.js), Python (Django REST Framework), and Go (net/http).

REST API Design Patterns

Name: REST API Design Patterns
Author: affaan-m

byaffaan-m

•

130,863

•

API 开发

Standardizes REST API architecture using consistent naming, semantic status codes, and scalable implementation patterns for production services.

This skill provides a comprehensive framework for designing consistent, developer-friendly REST APIs within Claude Code. It guides the agent in creating resource-oriented URL structures, selecting correct HTTP status codes, and implementing robust features like cursor-based pagination, complex filtering, and sparse fieldsets. By following these industry-standard conventions, the skill helps ensure that your backend services are scalable, maintainable, and provide a superior developer experience through predictable error handling and versioning strategies.

主要功能

01Dual-strategy pagination guidance for both Offset and Cursor-based implementations

02130,863 GitHub stars

03Standardized resource naming conventions using kebab-case and plural nouns

04Best practices for API versioning, deprecation timelines, and rate limiting headers

05Comprehensive mapping of semantic HTTP status codes for success and error states

06Robust patterns for filtering, sorting, and full-text search query parameters

使用场景

01Architecting new RESTful microservices with production-grade consistency from the start

02Refactoring legacy API endpoints to align with modern REST best practices and naming conventions

03Designing standardized error response formats and validation logic for client-side consumption

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add affaan-m/everything-claude-code api-design

For use in Claude.ai and ChatGPT

主要功能

01Dual-strategy pagination guidance for both Offset and Cursor-based implementations

02130,863 GitHub stars

03Standardized resource naming conventions using kebab-case and plural nouns

04Best practices for API versioning, deprecation timelines, and rate limiting headers

05Comprehensive mapping of semantic HTTP status codes for success and error states

06Robust patterns for filtering, sorting, and full-text search query parameters

使用场景

01Architecting new RESTful microservices with production-grade consistency from the start

02Refactoring legacy API endpoints to align with modern REST best practices and naming conventions

03Designing standardized error response formats and validation logic for client-side consumption