← Все новости
Документация GraphQL на русском: перевод официального руководства
В разделе «Документация → GraphQL» теперь полный перевод официального руководства «Learn» с сайта graphql.org — от системы типов до рекомендаций по проектированию API.
Что внутри
- Схема и типы — объектные типы, поля и аргументы, скаляры и перечисления, списки и обязательные значения, интерфейсы, объединения, входные типы, директивы и описания.
- Операции — запросы с псевдонимами, переменными, фрагментами и директивами
@includeи@skip, изменения и подписки. - Жизненный цикл запроса — как сервер проверяет и выполняет запрос, что приходит в ответе: данные, ошибки запроса и ошибки полей, частичные ответы.
- Интроспекция — запросы
__schemaи__type: как узнать схему существующего API. - Практики — курсорная пагинация и соединения Relay, глобальная идентификация объектов, развитие схемы без версий, обязательность полей, соглашения об именовании и анти-паттерны.
Примеры с настоящими ответами
Как и в оригинале, примеры построены на демонстрационной схеме «Звёздных войн». Рядом с каждым запросом — ответ сервера, полученный выполнением этого запроса, в том числе ответы с ошибками проверки и частичные ответы. Полная схема примеров и другие схемы открываются в редакторе кнопкой «Открыть в редакторе».
Гайды и карта схемы
Появились гайды по GraphQL: как работать в редакторе схемы, разбираться в карте типов, получить SDL из ответа introspection и проверить схему. А карточки типов на карте теперь можно перетаскивать мышью — расположение сохраняется вместе со схемой и в истории версий.
