← Все новости

Документация GraphQL на русском: перевод официального руководства

В разделе «Документация → GraphQL» теперь полный перевод официального руководства «Learn» с сайта graphql.org — от системы типов до рекомендаций по проектированию API.

Что внутри

  • Схема и типы — объектные типы, поля и аргументы, скаляры и перечисления, списки и обязательные значения, интерфейсы, объединения, входные типы, директивы и описания.
  • Операции — запросы с псевдонимами, переменными, фрагментами и директивами @include и @skip, изменения и подписки.
  • Жизненный цикл запроса — как сервер проверяет и выполняет запрос, что приходит в ответе: данные, ошибки запроса и ошибки полей, частичные ответы.
  • Интроспекция — запросы __schema и __type: как узнать схему существующего API.
  • Практики — курсорная пагинация и соединения Relay, глобальная идентификация объектов, развитие схемы без версий, обязательность полей, соглашения об именовании и анти-паттерны.

Примеры с настоящими ответами

Как и в оригинале, примеры построены на демонстрационной схеме «Звёздных войн». Рядом с каждым запросом — ответ сервера, полученный выполнением этого запроса, в том числе ответы с ошибками проверки и частичные ответы. Полная схема примеров и другие схемы открываются в редакторе кнопкой «Открыть в редакторе».

Гайды и карта схемы

Появились гайды по GraphQL: как работать в редакторе схемы, разбираться в карте типов, получить SDL из ответа introspection и проверить схему. А карточки типов на карте теперь можно перетаскивать мышью — расположение сохраняется вместе со схемой и в истории версий.