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

web-development

Api designer — это скилл для Claude Code, который проектирует REST и GraphQL API, создаёт полные OpenAPI 3.1 спецификации и разрабатывает архитектуру API с моделированием ресурсов, стратегиями версионирования и стандартами обработки ошибок. Берут, когда нужно спроектировать новый API с нуля и не допустить хаоса с именованием и структурой ответов, когда команда хочет contract-first подход и живую документацию сразу, когда надо продумать пагинацию, deprecation-политику или правильную обработку ошибок по RFC 7807, когда разные сервисы должны говорить на одном языке. Скилл реализует пошаговый рабочий процесс: анализ домена, моделирование ресурсов с entity-диаграммой, проектирование URI и HTTP-методов, создание и валидация OpenAPI 3.1 спецификации через Redocly CLI, мок-сервер через Prism для проверки контрактов, планирование эволюции API. Включает справочники по REST-паттернам, версионированию, типам пагинации (cursor, offset, keyset) и готовые YAML-шаблоны. Направление — проектирование контракта до написания кода, а не документирование готового API постфактум. Связанные скиллы в каталоге: graphql-architect для углублённой работы со схемами GraphQL, fastapi-expert и nestjs-expert для реализации, security-reviewer для аудита безопасности.