Проектирование REST и GraphQL API

web-development

Api designer is a Claude Code skill that designs REST and GraphQL APIs, produces complete OpenAPI 3.1 specifications, and plans API architecture covering resource modeling, versioning strategies, and error-handling standards. Reach for it when starting a new API from scratch and wanting to lock in consistent naming and response shapes before a single line of code is written, when the team needs a contract-first workflow with ready-to-use documentation, when pagination patterns or a deprecation policy need to be worked out upfront, or when multiple services must share a coherent interface. The skill follows a structured workflow: analyze domain requirements, model resources with an entity diagram, define URI patterns and HTTP methods, generate and lint an OpenAPI 3.1 spec via Redocly CLI, spin up a Prism mock server to validate contracts, then plan API evolution. Built-in reference guides cover REST patterns, versioning, cursor/offset/keyset pagination, RFC 7807 error responses, and copy-paste YAML templates. The direction is designing the contract before implementation — not documenting an existing API after the fact (for deep GraphQL schema work use graphql-architect; for framework-level implementation use fastapi-expert or nestjs-expert; for security audit use security-reviewer).