Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Сведения API GraphQL

API GraphQL GitHub обеспечивает гибкость и возможность точно определить данные, которые необходимо получить.

Обзор

Ниже приведены быстрые ссылки, перейдя по которым, вы можете приступить к работе с API GraphQL:

Дополнительные сведения об APIGitHub см. в разделе Сведения об API GitHub.

Сведения о GraphQL

Язык запросов данных GraphQL:

  • Спецификация. Спецификация определяет допустимость схемы на сервере API. Схема определяет допустимость вызовов клиентов.

  • Строго типизированный. Схема определяет систему типов API и все отношения объектов.

  • Интроспективный. Клиент может запросить схему для получения сведений о схеме.

  • Иерархический. Фигура вызова GraphQL отражает фигуру возвращаемых данных JSON. Вложенные поля позволяют запрашивать и получать только данные, указанные в одном круговом пути.

  • Слой приложения. GraphQL не является моделью хранилища или языком запросов к базе данных. Граф ссылается на структуры графов, определенные в схеме, где узлы определяют объекты, а края определяют отношения между объектами. API обходит и возвращает данные приложения на основе определений схемы, независимо от способа хранения данных.

Почему GitHub использует GraphQL

GitHub использует GraphQL, так как он предлагает значительно большую гибкость для наших интеграторов. Возможность точно определить нужные данные—и только данные, которые вам нужны—, является значительным преимуществом по сравнению с традиционными конечными точками REST API. GraphQL позволяет заменить несколько запросов REST с помощью одного вызова для получения указанных данных.

Дополнительные сведения о том, почему GitHub инвестирует в GraphQL, см. в исходной записи блога с объявлением.

Сведения о ссылке на схему GraphQL

Документы на боковой панели создаются на основе схемы GraphQL GitHub. Все вызовы проверяются и выполняются согласно схеме. Используйте эти документы, чтобы узнать, какие данные можно вызвать:

Доступ к этому содержимому можно получить на боковой панели документации обозревателя. Обратите внимание, что для успешного вызова API GraphQL может потребоваться использовать как документы, так и проверку схемы.

Другие сведения, например о проверке подлинности и ограничении скорости, см. в руководствах.

Запрос поддержки

Для вопросов, отчетов об ошибках и обсуждений о GitHub Apps, OAuth Apps и разработке API изучите Обсуждения API и интеграции в сообществе GitHub. Обсуждения модерируются и обслуживаются сотрудниками GitHub, но гарантий того, что сотрудники GitHub ответят на вопросы, опубликованные на форуме, нет.

В службу поддержки GitHub можно обратиться напрямую через форму связи, чтобы получить:

  • гарантированный ответ от сотрудников GitHub;
  • запросы на поддержку, связанные с конфиденциальными данными или частными проблемами;
  • запросы функций;
  • отзывы о продуктах GitHub.