Skip to main content

Описание OpenAPI для REST API

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

Сведения о OpenAPI

OpenAPI — это спецификация для описания интерфейсов REST API. Он описывает API без доступа к исходному коду или дополнительной документации. Спецификация — это человеческая и машинная удобочитаемая. Дополнительные сведения см . в документации по спецификации OpenAPI.

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

Описание OpenAPI в формате GitHubв REST API является общедоступным. Описание можно найти в репозитории открытый код github/rest-api-description.

GitHub предоставляет описания 3.0 и 3.1 OpenAPI.

Для каждого описания существует версия для каждого продукта: GitHub Free/GitHub Pro/GitHub Team (api.github.com), GitHub Enterprise Cloud (ghec) и каждая версия GitHub Enterprise Server (ghes-X.X).

Для каждого продукта, если поддерживается управление версиями на основе дат, существует также описание каждой версии на основе дат. Дополнительные сведения см. в разделе Версии API.

Каждое описание доступно в пакетном или в разыменоваемом формате. Пакетный формат используется $ref для ссылки на компоненты OpenAPI, которые совместно используются между конечными точками. Формат разыменовки включает полностью развернутое описание.

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

Так как описание OpenAPI доступно для чтения на компьютере, его можно использовать для выполнения таких действий:

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

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