> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Versionado

> Estrategia de versionado de X API y política de obsolescencia

La X API utiliza números de versión en las rutas de los endpoints para ofrecer estabilidad y, al mismo tiempo, permitir la evolución. Comprender nuestra estrategia de versionado te ayuda a planificar tus integraciones y mantenerte al día.

***

<div id="current-versions">
  ## Versiones actuales
</div>

| Versión        | Estado     | Descripción                                                       |
| :------------- | :--------- | :---------------------------------------------------------------- |
| **v2**         | Vigente    | Endpoints modernos, precios flexibles, todas las nuevas funciones |
| **v1.1**       | Heredada   | Soporte limitado, actualizaciones mínimas                         |
| **Enterprise** | Disponible | Acceso de alto volumen con soporte dedicado                       |

<Tip>
  Usa **X API v2** para todos los proyectos nuevos. Es donde se lanzan todas las nuevas funciones.
</Tip>

***

<div id="version-in-urls">
  ## Versión en las URL
</div>

El número de versión aparece en la ruta del endpoint:

```
https://api.x.com/2/tweets
                   ^
                   version
```

***

<div id="breaking-vs-non-breaking-changes">
  ## Cambios incompatibles vs. compatibles
</div>

<div id="breaking-changes-require-code-updates">
  ### Cambios incompatibles con versiones anteriores (requieren actualizaciones de código)
</div>

Estos cambios solo ocurren en versiones principales:

* Eliminar un endpoint
* Eliminar un campo de la respuesta
* Eliminar un parámetro de consulta
* Agregar un nuevo parámetro obligatorio
* Cambiar el tipo de datos de un campo
* Cambiar el nombre de un campo o recurso
* Cambiar códigos de respuesta o tipos de error
* Modificar scopes de autorización

<div id="non-breaking-changes-additive">
  ### Cambios retrocompatibles (aditivos)
</div>

Estos pueden ocurrir en cualquier momento sin cambios de versión:

* Agregar un nuevo endpoint
* Agregar un nuevo parámetro opcional
* Agregar un nuevo campo de respuesta
* Agregar nuevos scopes de OAuth
* Cambiar el texto del mensaje de error
* Establecer campos como null por razones de privacidad o seguridad

***

<div id="release-schedule">
  ## Calendario de lanzamientos
</div>

| Tipo                      | Frecuencia               | Aviso previo                                        |
| :------------------------ | :----------------------- | :-------------------------------------------------- |
| **Versiones principales** | No más de una vez al año | Se proporcionan guías de migración                  |
| **Cambios compatibles**   | De forma continua        | Actualizaciones del registro de cambios (changelog) |
| **Parches de seguridad**  | Según sea necesario      | Pueden aplicarse a la versión actual                |

***

<div id="deprecation-policy">
  ## Política de obsolescencia
</div>

Cuando lanzamos una nueva versión principal:

1. **Obsolescencia**: La versión anterior se marca como obsoleta
2. **Periodo de soporte**: La versión obsoleta continúa funcionando durante un periodo definido
3. **Retirada**: La versión obsoleta se elimina

<div id="definitions">
  ### Definiciones
</div>

| Estado       | Significado                                                        |
| :----------- | :----------------------------------------------------------------- |
| **Activo**   | Con soporte completo, con nuevas funciones y correcciones          |
| **Obsoleto** | Sin nuevas funciones; solo errores críticos; se desaconseja su uso |
| **Retirado** | Ya no disponible                                                   |

***

<div id="staying-informed">
  ## Mantenerse informado
</div>

Recibe notificaciones sobre los cambios:

<CardGroup cols={2}>
  <Card title="Registro de cambios" icon="clock-rotate-left" href="/es/changelog">
    Todos los cambios y actualizaciones de la plataforma.
  </Card>

  <Card title="Anuncios del foro" icon="bullhorn" href="https://devcommunity.x.com/c/announcements/22">
    Avisos de cambios incompatibles.
  </Card>

  <Card title="@XDevelopers" icon="x-twitter" href="https://x.com/XDevelopers">
    Noticias y actualizaciones de la plataforma.
  </Card>

  <Card title="Boletín" icon="envelope" href="/es/newsletter">
    Resumen mensual.
  </Card>
</CardGroup>

***

<div id="migration-resources">
  ## Recursos de migración
</div>

Cuando se publica una nueva versión, proporcionamos:

* **Guías de migración**: instrucciones de actualización paso a paso
* **Asignación de endpoints**: equivalencias de v1 a v2
* **Cambios en el formato de datos**: diferencias en el modelo de objetos

<CardGroup cols={2}>
  <Card title="Resumen de la migración" icon="route" href="/es/x-api/migrate/overview">
    Recomendaciones actuales para la migración.
  </Card>

  <Card title="Mapa de endpoints" icon="map" href="/es/x-api/migrate/x-api-endpoint-map">
    Asignación de endpoints de v1 a v2.
  </Card>
</CardGroup>

***

<div id="best-practices">
  ## Mejores prácticas
</div>

<CardGroup cols={2}>
  <Card title="Usa v2" icon="arrow-up">
    Inicia los nuevos proyectos en la versión más reciente.
  </Card>

  <Card title="Sigue los anuncios" icon="bell">
    Suscríbete al registro de cambios y a las actualizaciones del foro.
  </Card>

  <Card title="Prueba los cambios" icon="flask">
    Prueba los cambios en desarrollo antes de aplicarlos en producción.
  </Card>

  <Card title="Planifica las migraciones" icon="calendar">
    No esperes a que se declare obsoleta para actualizar.
  </Card>
</CardGroup>