{"meta":{"title":"Versiones de API","intro":"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.","product":"REST API","breadcrumbs":[{"href":"/es/enterprise-cloud@latest/rest","title":"REST API"},{"href":"/es/enterprise-cloud@latest/rest/about-the-rest-api","title":"Acerca de la API de REST"},{"href":"/es/enterprise-cloud@latest/rest/about-the-rest-api/api-versions","title":"Versiones de API"}],"documentType":"article"},"body":"# Versiones de API\n\nObtenga 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.\n\n## Acerca del control de versiones de la API\n\nLa GitHub API REST 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ó en Tue, 10 Mar 2026.\n\nLos cambios disruptivos son cambios que pueden interrumpir una integración. Los cambios importantes se publicarán en una nueva versión de API. Proporcionaremos un aviso anticipado antes de implementar cambios disruptivos. Los cambios importantes incluyen:\n\n* Eliminación de una operación completa\n* Eliminación o cambio del nombre de un parámetro\n* Eliminación o cambio del nombre de un campo de respuesta\n* Adición de un nuevo parámetro obligatorio\n* Hacer que se requiera un parámetro anteriormente opcional\n* Cambio del tipo de un parámetro o campo de respuesta\n* Eliminación de valores de enumeración\n* Adición de una nueva regla de validación a un parámetro existente\n* Cambio de los requisitos de autenticación o autorización\n\nTodos 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:\n\n* Adición de una operación\n* Adición de un parámetro opcional\n* Adición de un encabezado de solicitud opcional\n* Adición de un campo de respuesta\n* Adición de un encabezado de respuesta\n* Agregar valores de enumeración\n\nCuando 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.\n\n## Especificación de una versión de API\n\nDebe usar el encabezado `X-GitHub-Api-Version` para especificar una versión de API. Por ejemplo:\n\n```shell\ncurl --encabezado \"X-GitHub-Api-Version:2026-03-10\" https://api.github.com/zen\n```\n\nLas solicitudes sin el encabezado `X-GitHub-Api-Version` usarán de forma predeterminada la versión `2022-11-28`.\n\nSi especifica una versión de API que ya no se admite, recibirá una `410 Gone` respuesta.\n\n## Actualización a una nueva versión de API\n\nAntes 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](/es/enterprise-cloud@latest/rest/overview/breaking-changes).\n\nAl 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.\n\nUna vez actualizada la integración, pruébala para comprobar que funciona con la nueva versión de API.\n\n## Versión de API cerrar definitivamente\n\nLas versiones de API se admiten durante 24 meses después de que se publique una versión más reciente de la API.\n\nAunque una versión está dentro de su ventana de soporte técnico y se aproxima a cerrar definitivamente, GitHub incluye los siguientes encabezados en las respuestas de la API para ayudarle a prepararse para la migración.\n\n* `Deprecation` : la fecha en que la versión de la API será cerrar definitivamente, con formato de fecha HTTP por [RFC 7231](https://tools.ietf.org/html/rfc7231#section-7.1.1.1). Por ejemplo: `Wed, 27 Nov 2019 14:34:29 GMT`. <!-- markdownlint-disable-line GHD046 -->\n* `Sunset` : la fecha en que se quitará completamente la versión de la API (retirado), después de la cual las solicitudes devolverán una `410 Gone` respuesta. Sigue [RFC 8594](https://tools.ietf.org/html/rfc8594). Por ejemplo: `Fri, 27 Nov 2020 14:34:29 GMT`. <!-- markdownlint-disable-line GHD046 -->\n\nUna vez finalizada la ventana de soporte técnico:\n\n* Las solicitudes que especifican una cerrar definitivamente versión de API reciben una `410 Gone` respuesta.\n* Las solicitudes que no especifican una versión de API tienen como valor predeterminado la siguiente versión compatible más antigua, no la cerrar definitivamente versión. Si utiliza solicitudes sin versión, es posible que observe cambios de comportamiento a medida que se deja de dar soporte a las versiones anteriores.\n\nPara obtener más información sobre la migración a una versión más reciente de la API, consulte [Cambios disruptivos](/es/enterprise-cloud@latest/rest/about-the-rest-api/breaking-changes).\n\n## Excepciones al control de versiones estándar\n\nEn raras ocasiones, GitHub puede realizar cambios fuera de la cadencia normal del control de versiones de api. Estas son intervenciones excepcionales que no modifican las garantías de control de versiones estándar para la mayoría de los integradores.\n\n### Problemas de seguridad, disponibilidad y confiabilidad\n\nLas vulnerabilidades de seguridad críticas, los riesgos de exposición de datos o los problemas de confiabilidad graves pueden requerir cambios fuera de la programación de lanzamiento normal.\nGitHub puede publicar una versión de API no programada, aplicar correcciones retrospectivas a versiones admitidas o, en raras ocasiones, introducir un cambio significativo en una versión existente para proteger a los usuarios y la integridad de la plataforma.\n\nGitHub comunicará estos cambios a través de notas de la versión, registros de cambios y comunicación directa que explique qué ha cambiado y por qué. Cuando sea factible, se proporcionará un aviso previo. Se puede realizar una acción inmediata sin previo aviso cuando sea necesario.\n\n### Servicios de uso bajo\n\nPara determinados servicios con un uso muy bajo, GitHub puede dejar de usar la funcionalidad fuera del proceso de control de versiones estándar. En estos casos, GitHub comunicará la intención y se pondrá en contacto directamente con los integradores afectados.\n\n## Versiones de API admitidas\n\nActualmente se admiten las siguientes versiones de la API REST.\n\n| Versión de API | Fecha de finalización del soporte técnico |\n| -------------- | ----------------------------------------- |\n| `2026-03-10`   | Not yet scheduled                         |\n| `2022-11-28`   | March 10, 2028                            |\n\nTambié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](/es/enterprise-cloud@latest/rest/meta/meta#get-all-api-versions)."}