Does this skill support both REST and GraphQL?

Yes, it provides detailed patterns for both RESTful resource-oriented design and GraphQL schema-first development, including resolvers and mutations.

What versioning strategies are included?

The skill covers multiple industry-standard versioning methods including URL paths, custom headers, and query parameters.

How does it help with API performance?

It includes specific patterns for efficient pagination, filtering, and GraphQL DataLoaders to prevent the common N+1 query problem.

Can I use this to establish team standards?

Absolutely. It defines consistent naming conventions, status code usage, and error response structures that serve as an excellent baseline for team-wide API standards.

API Design Principles

Name: API Design Principles
Author: workonthestreets

byworkonthestreets

0•

API 开发

Implements industry-leading REST and GraphQL standards to build scalable, developer-centric APIs.

This skill provides comprehensive guidance for architecting robust APIs using both REST and GraphQL paradigms. It helps developers establish resource-oriented architectures, implement efficient pagination and filtering, manage consistent error handling, and design strongly-typed GraphQL schemas. Whether you are refactoring legacy endpoints or starting a new project, this skill ensures your API design is intuitive, maintainable, and optimized for performance while preventing common pitfalls like the N+1 problem and inconsistent status codes.

主要功能

01Advanced pagination, filtering, and HATEOAS patterns

02GraphQL schema-first development and resolver optimization

030 GitHub stars

04Standardized error handling and HTTP status code mapping

05Resource-oriented RESTful architecture design

06API versioning strategies and N+1 prevention with DataLoaders

使用场景

01Standardizing API specifications across a development team

02Optimizing API performance and developer experience for third-party integrations

03Architecting new REST or GraphQL backends from scratch

主要功能

01Advanced pagination, filtering, and HATEOAS patterns

02GraphQL schema-first development and resolver optimization

030 GitHub stars

04Standardized error handling and HTTP status code mapping

05Resource-oriented RESTful architecture design

06API versioning strategies and N+1 prevention with DataLoaders

使用场景

01Standardizing API specifications across a development team

02Optimizing API performance and developer experience for third-party integrations

03Architecting new REST or GraphQL backends from scratch