Is this skill specific to a particular programming language?

While the code examples feature Python and FastAPI, the core design principles are language-agnostic and can be applied to any backend framework or language.

Does this skill support both REST and GraphQL?

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

When is the best time to use this skill?

Use it during the initial design phase of a project, during code reviews of API specifications, or when refactoring existing services to improve usability.

Can it help with API versioning?

Absolutely. It includes strategies for URL, header, and query parameter versioning to help you manage breaking changes effectively.

How does it handle complex GraphQL issues like the N+1 problem?

It provides specific patterns for implementing DataLoaders to batch database requests and optimize performance in GraphQL resolvers.

API Design Principles

Name: API Design Principles
Author: GaitanS

byGaitanS

0•

API 开发

Guides the creation of robust, scalable, and developer-friendly REST and GraphQL APIs using industry best practices.

This skill provides comprehensive architectural guidance for building modern APIs using REST and GraphQL paradigms. It focuses on industry-standard best practices, including resource-oriented design, schema-first GraphQL development, effective versioning strategies, and robust error handling patterns. Whether you are designing a new service from scratch, refactoring legacy endpoints, or establishing team-wide standards, this skill helps ensure your APIs are intuitive, maintainable, and highly performant for both internal and external developers.

主要功能

01RESTful resource-oriented architecture and HTTP method semantics

02GraphQL schema-first design and query optimization patterns

03Standardized error handling and HTTP status code implementations

040 GitHub stars

05API versioning strategies including URL, header, and query parameters

06N+1 problem prevention using DataLoaders and batch loading

使用场景

01Designing new REST or GraphQL APIs for microservices

02Migrating legacy monolithic endpoints to a modern API architecture

03Establishing organizational API standards and developer documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gaitans/ai-mancare api-design-principles

For use in Claude.ai and ChatGPT

Download Skill