{"meta":{"title":"Сведения API GraphQL","intro":"GitHub API GraphQL предлагает гибкость и возможность точно определить нужные вам данные.","product":"API GraphQL","breadcrumbs":[{"href":"/ru/graphql","title":"API GraphQL"},{"href":"/ru/graphql/overview","title":"Обзор"},{"href":"/ru/graphql/overview/about-the-graphql-api","title":"Сведения API GraphQL"}],"documentType":"article"},"body":"# Сведения API GraphQL\n\nGitHub API GraphQL предлагает гибкость и возможность точно определить нужные вам данные.\n\n## Обзор\n\nНиже приведены быстрые ссылки, перейдя по которым, вы можете приступить к работе с API GraphQL:\n\n* [Аутентификация](/ru/graphql/guides/forming-calls-with-graphql#authenticating-with-graphql)\n* [Корневая конечная точка](/ru/graphql/guides/forming-calls-with-graphql#the-graphql-endpoint)\n* [Интроспекция схемы](/ru/graphql/guides/introduction-to-graphql#discovering-the-graphql-api)\n* [Пределы скорости](/ru/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api)\n* [Переход с REST](/ru/graphql/guides/migrating-from-rest-to-graphql)\n\nДля получения дополнительной информации об GitHubAPI с (AUTOTITLE) см. [Сравнение REST API GitHub и GraphQL API](/ru/rest/about-the-rest-api/comparing-githubs-rest-api-and-graphql-api).\n\n## Сведения о GraphQL\n\nЯзык запросов данных [GraphQL](https://graphql.org/):\n\n* **[Спецификация](https://spec.graphql.org/June2018/).** Спецификация определяет валидность [schema](/ru/graphql/guides/introduction-to-graphql#schema) на сервере API. Схема определяет допустимость вызовов клиентов.\n\n* **[Строго типизированный](#about-the-graphql-schema-reference).** Схема определяет систему типов API и все отношения объектов.\n\n* **[Интроспективный](/ru/graphql/guides/introduction-to-graphql#discovering-the-graphql-api).** Клиент может запросить схему для получения сведений о схеме.\n\n* **[иерархически](/ru/graphql/guides/forming-calls-with-graphql).** Фигура вызова GraphQL отражает фигуру возвращаемых данных JSON. [вложенные поля](/ru/graphql/guides/migrating-from-rest-to-graphql#example-nesting) позволяют делать запросы и получать только указанные данные в одном круговом маршруте.\n\n* **Слой приложения.** GraphQL — это не модель storage или язык запросов к базе данных.\n  *граф* относится к структурам графов, определённым в схеме, где [узлы](/ru/graphql/guides/introduction-to-graphql#node) определяют объекты, а [рёбра](/ru/graphql/guides/introduction-to-graphql#edge) определяют отношения между объектами. API обходит и возвращает данные приложения на основе определений схемы, независимо от способа хранения данных.\n\n## Почему GitHub использует GraphQL\n\nGitHub выбрал GraphQL, потому что он предлагает нашим интеграторам значительно больше гибкости. Возможность точно определить нужные данные—и *только* данные, которые вам нужны—, является значительным преимуществом по сравнению с традиционными конечными точками REST API. GraphQL позволяет заменить несколько запросов REST с помощью *одного вызова* для получения указанных данных.\n\nДля получения дополнительной информации о том, почему GitHub инвестировали в GraphQL, смотрите оригинальный блог<<c0>анонс/c0>.\n\n## Сведения о ссылке на схему GraphQL\n\nДокументы в боковой панели генерируются из GitHub[схемы](/ru/graphql/guides/introduction-to-graphql#discovering-the-graphql-api) GraphQL. Все вызовы проверяются и выполняются согласно схеме. Используйте эти документы, чтобы узнать, какие данные можно вызвать:\n\n* Разрешённые операции: запросы и мутации.\n\n* Типы, определённые схемой: скаляры, объекты, enums, интерфейсы, объединения и входные объекты.\n\nДля другой информации, например, аутентификации и ограничения скорости, посмотрите [guides](/ru/graphql/guides).\n\n## Запрос поддержки\n\nДля вопросов, отчетов об ошибках и обсуждениях о GitHub Apps, OAuth appsи разработке API, изучите [Категория API и веб-перехватчиков в обсуждениях сообщества GitHub](https://github.com/orgs/community/discussions/categories/api-and-webhooks). Обсуждения модерируются и поддерживаются сотрудниками GitHub и отвечают сообществу GitHub.\n\nВ [службу поддержки GitHub](https://support.github.com/) можно обратиться напрямую через форму связи, чтобы получить:\n\n* Гарантированный ответ от персонала GitHub\n* Запросы на поддержку, связанные с конфиденциальными данными или частными проблемами\n* Запросы функций\n* Отзывы о продуктах GitHub\n\nЕсли вы наблюдаете неожиданные сбои, вы можете использовать [githubstatus.com](https://www.githubstatus.com/) или [GitHub API статуса](https://www.githubstatus.com/api) для проверки инцидентов, влияющих на API."}