Skip to main content

Sobre a descrição da OpenAPI para a API REST

A API REST de GitHub Enterprise Cloud está totalmente descrita em um documento compatível com a OpenAPI.

Sobre a OpenAPI

OpenAPI é uma especificação para descrever interfaces de API REST. Descreve a API sem exigir acesso ao código-fonte ou documentação adicional. A especificação é legível por seres humanos e máquinas. Para obter mais informações, consulte a documentação de especificação OpenAPI.

Sobre a descrição da OpenAPI da GitHub

A descrição da OpenAPI da GitHub da API REST está disponível publicamente. Você pode encontrar a descrição no repositório de código aberto github/rest-api-description.

A GitHub fornece descrições da OpenAPI 3.0 e 3.1.

Há uma versão da descrição para cada produto: GitHub Free/GitHub Pro/GitHub Team (api.github.com), GitHub Enterprise Cloud (ghec), e cada versão do GitHub Enterprise Server (ghes-X.X).

Para cada produto, se houver suporte para o controle de versão baseado em data, também haverá uma descrição para cada versão baseada em data. Para obter mais informações, veja "Versões da API."

Cada descrição está disponível em um pacote ou em um formato sem referência. O formato empacotado usa $ref para se referir a componentes da OpenAPI que são compartilhados entre pontos de extremidade. O formato sem referência inclui a descrição totalmente expandida.

Usara descrição da OpenAPI de GitHub

Como a descrição do OpenAPI é legível por máquina, você pode usá-la para realizar ações como:

  • Gerar bibliotecas para facilitar o uso da API REST
  • Validar e testar uma integração que usa a API REST
  • Explorar e interagir com a API REST usando ferramentas de terceiros, como Insomnia ou Postman

Por exemplo, a GitHub usa a descrição da OpenAPI para gerar os SDKs Octokit. A GitHub também usa a descrição da OpenAPI para gerar a documentação de referência da API REST para cada ponto de extremidade.