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

# Versionado

> Cómo funciona el versionado de la X API, la diferencia entre v1.1, v2 y enterprise, y qué cambios se consideran rompedores frente a actualizaciones aditivas.

La X API usa números de versión en las rutas de los endpoints para brindar estabilidad al mismo tiempo que permite la evolución. Comprender nuestra estrategia de versionado te ayuda a planificar integraciones y mantenerte al día.

***

## Versiones actuales

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

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

***

## Versión en las URLs

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

```
https://api.x.com/2/tweets
                   ^
                   versión
```

***

## Cambios rompedores vs. no rompedores

### Cambios rompedores (requieren actualizaciones de código)

Estos cambios solo ocurren en aumentos de versión mayor:

* Eliminar un endpoint
* Eliminar un campo de respuesta
* Eliminar un parámetro de consulta
* Añadir un nuevo parámetro requerido
* Cambiar el tipo de dato de un campo
* Renombrar un campo o recurso
* Cambiar los códigos de respuesta o tipos de error
* Modificar los scopes de autorización

### Cambios no rompedores (aditivos)

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

* Añadir un nuevo endpoint
* Añadir un nuevo parámetro opcional
* Añadir un nuevo campo de respuesta
* Añadir nuevos scopes de OAuth
* Cambiar el texto de mensajes de error
* Anular campos por razones de privacidad/seguridad

***

## Calendario de lanzamientos

| Tipo                      | Frecuencia               | Aviso                                |
| :------------------------ | :----------------------- | :----------------------------------- |
| **Versiones mayores**     | No más de una vez al año | Se proporcionan guías de migración   |
| **Cambios no rompedores** | Continuos                | Actualizaciones del changelog        |
| **Parches de seguridad**  | Según sea necesario      | Pueden aplicarse a la versión actual |

***

## Política de deprecación

Cuando lanzamos una nueva versión mayor:

1. **Deprecación**: La versión anterior se marca como deprecada
2. **Período de soporte**: La versión deprecada sigue funcionando durante un período definido
3. **Retirada**: La versión deprecada se elimina

### Definiciones

| Estado        | Significado                                                     |
| :------------ | :-------------------------------------------------------------- |
| **Activo**    | Totalmente compatible con nuevas funciones y correcciones       |
| **Deprecado** | Sin nuevas funciones; solo bugs críticos; se desaconseja su uso |
| **Retirado**  | Ya no es accesible                                              |

***

## Mantente informado

Recibe notificaciones sobre cambios:

<CardGroup cols={2}>
  <Card title="Changelog" icon="https://mintcdn.com/x-preview/szd6PKNMlRQoyyAo/icons/xds/icon-history.svg?fit=max&auto=format&n=szd6PKNMlRQoyyAo&q=85&s=6afe17587c08ee621e37afde19a07ff1" href="/changelog" width="24" height="24" data-path="icons/xds/icon-history.svg">
    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 rompedores.
  </Card>

  <Card title="@XDevelopers" icon="https://mintcdn.com/x-preview/SxzTbJaLjs3MidH1/icons/xds/icon-logo-x.svg?fit=max&auto=format&n=SxzTbJaLjs3MidH1&q=85&s=53e3153f3b8d6efdad31484ef133b274" href="https://x.com/XDevelopers" width="24" height="24" data-path="icons/xds/icon-logo-x.svg">
    Noticias y actualizaciones de la plataforma.
  </Card>

  <Card title="Newsletter" icon="https://mintcdn.com/x-preview/UIyI4eSwiP2OpODQ/icons/xds/icon-envelope.svg?fit=max&auto=format&n=UIyI4eSwiP2OpODQ&q=85&s=fbd38dbcd64d8688d3c9912ac30c4621" href="/newsletter" width="24" height="24" data-path="icons/xds/icon-envelope.svg">
    Resumen mensual.
  </Card>
</CardGroup>

***

## Recursos de migración

Cuando se lanza una nueva versión, proporcionamos:

* **Guías de migración**: Instrucciones de actualización paso a paso
* **Mapa de endpoints**: Equivalentes de v1 a v2
* **Cambios de formato de datos**: Diferencias del modelo de objetos

<CardGroup cols={2}>
  <Card title="Descripción general de la migración" icon="route" href="/x-api/migrate/overview">
    Orientación actual de migración.
  </Card>

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

***

## Buenas prácticas

<CardGroup cols={2}>
  <Card title="Usa v2" icon="arrow-up">
    Comienza nuevos proyectos con la última versión.
  </Card>

  <Card title="Monitoriza anuncios" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-bell.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=5e0b3dcfbb39ba3d4619931d7cd927d1" width="24" height="24" data-path="icons/xds/icon-bell.svg">
    Suscríbete al changelog y a las actualizaciones del foro.
  </Card>

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

  <Card title="Planifica migraciones" icon="calendar">
    No esperes hasta la deprecación para actualizar.
  </Card>
</CardGroup>