Does this skill support both REST and GraphQL?

Yes, it provides detailed design patterns and implementation examples for both RESTful resource-oriented architectures and schema-first GraphQL APIs.

Is it compatible with modern frameworks like FastAPI or Apollo?

Yes, the principles and patterns provided are framework-agnostic but include practical implementation examples for modern tools like FastAPI and Ariadne.

Can it help me solve performance issues like the N+1 problem?

Absolutely. It includes specific guidance and code patterns for using DataLoaders in GraphQL to batch requests and prevent inefficient database querying.

How does this help with API versioning?

It outlines multiple strategies for API evolution, including URL, header, and query parameter versioning, helping you manage breaking changes without disrupting clients.

API Design Principles

Name: API Design Principles
Author: amurata

byamurata

•

API Development

Masters the art of building intuitive, scalable, and maintainable REST and GraphQL APIs using industry-standard patterns and best practices.

About

This skill empowers developers to architect robust backends by providing comprehensive guidance on RESTful and GraphQL design principles. It covers everything from resource-oriented architecture and HTTP semantics to schema-first GraphQL development and N+1 problem mitigation using DataLoaders. Whether you are establishing team standards, reviewing API specifications before implementation, or refactoring legacy services for a better developer experience, this skill ensures your APIs are professional, consistent, and built to withstand the test of time.

Key Features

Schema-first GraphQL development and resolver optimization
Robust error handling and HTTP status code mapping
Advanced patterns like HATEOAS and DataLoader for performance
3 GitHub stars
Standardized RESTful resource and collection design patterns
Comprehensive API versioning and evolution strategies

Use Cases

Designing a new high-performance REST or GraphQL backend from scratch
Refactoring legacy API endpoints to improve usability and developer experience
Establishing a consistent set of API standards and documentation for engineering teams

About

Key Features

Schema-first GraphQL development and resolver optimization
Robust error handling and HTTP status code mapping
Advanced patterns like HATEOAS and DataLoader for performance
3 GitHub stars
Standardized RESTful resource and collection design patterns
Comprehensive API versioning and evolution strategies

Use Cases

Designing a new high-performance REST or GraphQL backend from scratch
Refactoring legacy API endpoints to improve usability and developer experience
Establishing a consistent set of API standards and documentation for engineering teams