How does this skill help with API versioning?

It provides specific implementation strategies for URI, Header, and Query Parameter versioning, including guidance on deprecation headers and sunsetting policies.

Does it cover API security and rate limiting?

Absolutely, it includes best practices for authentication patterns like JWT and API Keys, as well as standard rate limiting headers (RFC 6585).

Is it compatible with OpenAPI standards?

Yes, the patterns are designed to align with OpenAPI specifications and GraphQL Schema definitions to ensure consistent, interactive documentation.

Can it help with both REST and GraphQL?

Yes, it contains patterns for resource-oriented REST design as well as GraphQL query structure, mutation patterns, and error extensions.

What types of pagination are supported?

The skill guides you through choosing and implementing Offset-based, Cursor-based, or Keyset (Seek) pagination based on your dataset size and consistency needs.

API Design Patterns

Name: API Design Patterns
Author: NickCrew

byNickCrew

•

API Development

Standardizes API architecture with production-grade patterns for REST and GraphQL services, covering versioning, pagination, and error handling.

About

This skill provides Claude with expert-level guidance for designing scalable and maintainable REST and GraphQL APIs using industry-standard implementation patterns. It helps developers architect robust service contracts, implement complex pagination strategies like cursor-based or keyset navigation, and enforce consistent error handling and versioning across microservices. Whether building a backend from scratch or refactoring legacy endpoints, this skill ensures your APIs follow semantic HTTP principles, utilize secure authentication patterns, and optimize performance through field selection and caching strategies.

Key Features

Standardized error response formatting and semantic HTTP status code mapping.
Advanced pagination strategies including cursor, offset, and keyset methods.
7 GitHub stars
Comprehensive REST and GraphQL design patterns for scalable architectures.
Versioning strategies for URI, header, and query parameter approaches.
Implementation of idempotency, HATEOAS, and sparse fieldsets for performance.

Use Cases

Implementing efficient cursor-based pagination for high-performance data feeds.
Refactoring existing microservices to standardize error handling and authentication.
Designing a new production-grade REST API with resource-oriented URLs.

About

Key Features

Standardized error response formatting and semantic HTTP status code mapping.
Advanced pagination strategies including cursor, offset, and keyset methods.
7 GitHub stars
Comprehensive REST and GraphQL design patterns for scalable architectures.
Versioning strategies for URI, header, and query parameter approaches.
Implementation of idempotency, HATEOAS, and sparse fieldsets for performance.

Use Cases

Implementing efficient cursor-based pagination for high-performance data feeds.
Refactoring existing microservices to standardize error handling and authentication.
Designing a new production-grade REST API with resource-oriented URLs.