Does this skill cover both REST and GraphQL?

Yes, it provides detailed design patterns and best practices for both RESTful resource-oriented architecture and GraphQL schema-first development.

Is it specific to any programming language?

While the reference patterns include examples in Python (FastAPI and Ariadne), the core architectural principles are language-agnostic and apply to any backend technology stack.

Can I use this for refactoring existing APIs?

Absolutely. The skill includes specific guidance on versioning, pagination, and error handling, making it ideal for improving the usability and consistency of legacy APIs.

How does it help with GraphQL performance?

It specifically addresses the common N+1 query problem through the implementation of the DataLoader pattern and efficient resolver design patterns.

API Design Principles

Name: API Design Principles
Author: Microck

byMicrock

•

108

API 개발

Master REST and GraphQL API design to build scalable, developer-friendly, and maintainable backend services.

소개

This skill provides comprehensive guidance on architecting robust APIs using both REST and GraphQL paradigms. It equips Claude with the expertise to design resource-oriented endpoints, implement schema-first development, manage versioning strategies, and solve common challenges like the N+1 problem and efficient pagination. Whether you are building new services from scratch, refactoring legacy systems for better usability, or establishing organizational standards, this skill ensures your APIs follow industry best practices for long-term performance and developer delight.

주요 기능

Resource-oriented RESTful architecture patterns and HTTP semantics
Advanced pagination, filtering, and HATEOAS implementation
Schema-first GraphQL design with strong type definitions
108 GitHub stars
N+1 problem prevention using the DataLoader pattern
Standardized error handling and status code mapping

사용 사례

Designing a new scalable backend API for mobile or web applications
Refactoring existing endpoints to improve consistency and developer experience
Establishing organizational API standards and review checklists for teams

소개

주요 기능

Resource-oriented RESTful architecture patterns and HTTP semantics
Advanced pagination, filtering, and HATEOAS implementation
Schema-first GraphQL design with strong type definitions
108 GitHub stars
N+1 problem prevention using the DataLoader pattern
Standardized error handling and status code mapping

사용 사례

Designing a new scalable backend API for mobile or web applications
Refactoring existing endpoints to improve consistency and developer experience
Establishing organizational API standards and review checklists for teams