Эта версия GitHub Enterprise Server была прекращена 2023-09-25. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, повышения безопасности и новых функций выполните обновление до последней версии GitHub Enterprise Server. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

Описание OpenAPI

В этой статье

REST API GitHub Enterprise Server полностью описан в документе по OpenAPI 3.0.

Сведения об описаниях OpenAPI

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

Получение описания OpenAPI GitHub

Это описание можно найти в репозитории Описание OpenAPI REST API с открытым кодом.

Описание предоставляется в двух форматах. Пакетная версия работает в большинстве случаев, так как она включает компоненты OpenAPI для неоднократного использования и удобочитаемости. Если ваши средства не поддерживают встроенные ссылки на компоненты, мы также предоставляем полностью разыменованную версию.

Использование описания OpenAPI GitHub

Существует множество способов использования описания OpenAPI. Например, можно выполнить следующее.

  • Создать собственный клиент API.
  • Проверять и тестировать интеграцию REST API GitHub.
  • Исследовать и взаимодействовать с REST API GitHub Enterprise Server с помощью сторонних средств, таких как Insomnia или Postman.

Например, GitHub использует описание OpenAPI REST для создания справочной документации по REST API GitHub Enterprise Server.