Skip to main content

Esta versión de GitHub Enterprise Server se discontinuó el 2024-07-09. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise Server. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico de GitHub Enterprise.

Versiones de API

Obtenga más información sobre cómo especificar la versión de la API de REST que se va a usar cada vez que se realiza una solicitud a la API de REST.

Acerca del control de versiones de la API

La API REST GitHub Enterprise Server 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 2022-11-28 de la API se publicó el Mon, 28 Nov 2022.

Todos los cambios importantes se publicarán en una nueva versión de API. Los cambios importantes son cambios que pueden interrumpir una integración. Los cambios importantes incluyen:

  • quitar una operación completa
  • quitar un parámetro o cambiar su nombre
  • quitar un campo de respuesta o cambiar su nombre
  • agregar un nuevo parámetro obligatorio
  • hacer que se requiera un parámetro opcional anteriormente
  • cambiar el tipo de un parámetro o campo de respuesta
  • quitar valores de enumeración
  • agregar una nueva regla de validación a un parámetro existente
  • cambiar 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:

  • agregar una operación
  • agregar un parámetro opcional
  • agregar un encabezado de solicitud opcional
  • agregar un campo de respuesta
  • agregar un campo de respuesta
  • agregar 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 control de versiones de GitHub Enterprise Server y el control de versiones de la API REST

Las versiones de GitHub Enterprise Server se desacoplan de las versiones de la API REST. Puedes actualizar la versión de GitHub Enterprise Server pero mantener la misma versión de la API REST, siempre que la versión de la API se incluya en la versión de GitHub Enterprise Server. Del mismo modo, puedes actualizar la versión de la API REST sin actualizar los datos GitHub Enterprise Server, siempre y cuando la nueva versión de la API REST que elijas esté disponible para la versión de GitHub Enterprise Server.

Las notas de la versión de GitHub Enterprise Server indicarán cuándo ya no se admite una versión de la API REST. Para obtener más información, vea «Notas de la versión».

Especificación de una versión de API

Debes 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 la versión 2022-11-28 de forma predeterminada.

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 obtener más información, vea «Cambios importantes».

Al actualizar la integración para especificar la nueva versión de API en el encabezado X-GitHub-Api-Version, también deberás 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 obtener más información, vea «Puntos de conexión de la API de REST para metadatos».