Design REST and GraphQL APIs with OpenAPI specifications and pagination strategies.
npx skills add https://github.com/jacexh/skills --skill api-design-jacexh
Please help me install this Agent Skill. Skill: api-design Source: https://github.com/jacexh/skills/tree/main/skills/api-design Command: npx skills add https://github.com/jacexh/skills --skill api-design-jacexh
Provides clear, consistent patterns for defining REST and GraphQL endpoints, pagination, filtering, versioning, authentication, error handling, and API documentation so teams can build interoperable, maintainable backend services.
Design an API for a user management service with REST endpoints for CRUD, cursor pagination for lists, query filtering, bearer authentication, and an OpenAPI spec documenting each route.
High-intent search queries and answers about installing and using this skill.
To design a REST API with pagination, apply offset or cursor pagination patterns to return standardized response shapes with pagination metadata, and implement query filtering for nested resources to ensure scalable backend services.
API versioning and documentation with OpenAPI are best handled by implementing URL or header versioning strategies, generating Swagger schemas for your endpoints, and documenting standardized error formats and HTTP status codes for client generation.
Cursor pagination for REST and GraphQL APIs works by using a cursor pointer to fetch the next data set instead of an offset, returning pagination metadata in the response to maintain consistent performance across large lists.
You can use GraphQL and REST together in the same backend service by defining clear endpoint conventions for REST resources and GraphQL queries, applying consistent authentication and error handling formats across both API types.
Standardized API error handling should include consistent error formats, appropriate HTTP status codes, idempotency guidance for repeated requests, rate limiting headers, and HATEOAS links to guide client interactions.
You need to define idempotency and authentication for API endpoints when building services requiring secure, consistent responses, such as user management systems utilizing bearer authentication and protecting against duplicate request execution.
Awais68Design RESTful API endpoints with Pydantic validation and OpenAPI schemas.
Dokkabei97Design API contracts with OpenAPI and GraphQL schemas.
gizixImplement JWT authentication, RBAC, and protected endpoints for Flask applications.
JNZader-VaultExplain gRPC concepts including Protocol Buffers, streaming RPC types, and error handling.
