Acerca del control de versiones de la API
La API de REST GitHub tiene versiones. El nombre de la versión de la API se basa en la fecha en la que se publicó dicha versión. Por ejemplo, la versión 2026-03-10 de la API se publicó el Tue, 10 Mar 2026.
Los cambios importantes son cambios que pueden interrumpir una integración. Proporcionaremos un aviso anticipado antes de implementar cambios disruptivos. Los cambios importantes incluyen:
- Eliminación de una operación completa
- Eliminación o cambio del nombre de un parámetro
- Eliminación o cambio del nombre de un campo de respuesta
- Adición de un nuevo parámetro obligatorio
- Hacer que se requiera un parámetro anteriormente opcional
- Cambio del tipo de un parámetro o campo de respuesta
- Eliminación de valores de enumeración
- Adición de una nueva regla de validación a un parámetro existente
- Cambio de los requisitos de autenticación o autorización
Todos los cambios aditivos (no importantes) estarán disponibles en todas las versiones de API admitidas. Los cambios aditivos son cambios que no deben interrumpir una integración. Los cambios aditivos incluyen:
- Adición de una operación
- Adición de un parámetro opcional
- Adición de un encabezado de solicitud opcional
- Adición de un campo de respuesta
- Adición de un encabezado de respuesta
- Adición de valores de enumeración
Cuando se publica una nueva versión de la API REST, la versión anterior de la API se admitirá durante al menos 24 meses más después del lanzamiento de la nueva versión de la API.
Acerca del GitHub Enterprise Server control de versiones y el control de versiones de la API REST
GitHub Enterprise Server Las versiones están desacopladas de las versiones de la API REST. Puede actualizar la GitHub Enterprise Server versión, pero mantener la misma versión de la API REST, siempre que la versión de la API se incluya en la GitHub Enterprise Server versión. Del mismo modo, puede actualizar la versión de la API REST sin actualizar la GitHub Enterprise Server versión, siempre que la nueva versión de la API REST que elija esté disponible para la GitHub Enterprise Server versión.
Las notas de la GitHub Enterprise Server versión indicarán cuándo ya no se admite una versión de la API REST. Para más información, consulta Notas de lanzamiento.
Especificación de una versión de API
Debe usar el encabezado X-GitHub-Api-Version para especificar una versión de API. Por ejemplo:
curl --encabezado "X-GitHub-Api-Version:2022-11-28" https://api.github.com/zen
Las solicitudes sin el encabezado X-GitHub-Api-Version usarán de forma predeterminada la versión 2022-11-28.
Si especificas una versión de API que ya no se admite, recibirás un error 400.
Actualización a una nueva versión de API
Antes de actualizar a una nueva versión de la API REST, debes leer el registro de cambios de los cambios importantes que corresponde a la nueva versión de API para comprender qué cambios importantes se incluyen y para obtener más información sobre cómo actualizar a esa versión específica de API. Para más información, consulta Cambios disruptivos.
Al actualizar la integración para especificar la nueva versión de API en el encabezado X-GitHub-Api-Version, también deberá realizar los cambios necesarios para que la integración funcione con la nueva versión de API.
Una vez actualizada la integración, pruébala para comprobar que funciona con la nueva versión de API.
Versiones de API admitidas
Actualmente se admiten las siguientes versiones de la API REST:
2022-11-28
También puedes realizar una solicitud de API para obtener todas las versiones de la API admitidas. Para más información, consulta Puntos de conexión de la API de REST para metadatos.