Sobre alterações interruptivas na API REST
A API REST do GitHub tem controle de versão. O nome da versão da API é baseado na data em que a versão da API foi lançada. Por exemplo, a versão 2026-03-10 da API foi lançada em Tue, 10 Mar 2026.
Alterações interruptivas são alterações que podem potencialmente interromper uma integração. Forneceremos aviso prévio antes de liberar alterações significativas. As alterações interruptivas incluem:
- Removendo uma operação inteira
- Removendo ou renomeando um parâmetro
- Removendo ou renomeando um campo de resposta
- Adicionando um novo parâmetro obrigatório
- Tornando necessário um parâmetro que era opcional
- Alterando o tipo de um parâmetro ou campo de resposta
- Removendo valores de enumeração
- Adicionando uma nova regra de validação a um parâmetro existente
- Alterando os requisitos de autenticação ou autorização
Quaisquer alterações aditivas (não interruptivas) estarão disponíveis em todas as versões da API com suporte. Alterações aditivas são alterações que não devem interromper uma integração. As alterações aditivas incluem:
- Adicionando uma operação
- Adicionando um parâmetro opcional
- Adicionando um cabeçalho de solicitação opcional
- Adicionando um campo de resposta
- Adicionando um cabeçalho de resposta
- Adicionando valores de enumeração
Quando uma nova versão da API REST for lançada, a versão anterior da API terá suporte por pelo menos mais 24 meses após o lançamento da nova versão da API.
Para obter mais informações sobre as versões da API, confira Versões da API.
Atualizando para o nova versão da API
Antes de atualizar para uma nova versão da API REST, leia a seção nesta página que corresponde à nova versão da API para entender quais alterações interruptivas estão incluídas e saber mais sobre como atualizar para essa versão da API.
Ao atualizar sua integração para especificar a nova versão da API no cabeçalho X-GitHub-Api-Version, você também precisará fazer as alterações necessárias para que sua integração funcione com a nova versão da API.
Após a atualização da integração, teste sua integração para verificar se ela funciona com a nova versão da API.