> ## 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.

# Versionamento

> Como funciona o versionamento da API do X, a diferença entre v1.1, v2 e enterprise, e quais mudanças são consideradas breaking versus atualizações aditivas.

A API do X usa números de versão nos caminhos dos endpoints para fornecer estabilidade permitindo evolução. Entender nossa estratégia de versionamento ajuda você a planejar integrações e se manter atualizado.

***

## Versões atuais

| Versão         | Status     | Descrição                                                     |
| :------------- | :--------- | :------------------------------------------------------------ |
| **v2**         | Atual      | Endpoints modernos, preços flexíveis, todos os novos recursos |
| **v1.1**       | Legado     | Suporte limitado, atualizações mínimas                        |
| **Enterprise** | Disponível | Acesso de alto volume com suporte dedicado                    |

<Tip>
  Use **X API v2** para todos os novos projetos. É onde todos os novos recursos são lançados.
</Tip>

***

## Versão nas URLs

O número da versão aparece no caminho do endpoint:

```
https://api.x.com/2/tweets
                   ^
                   versão
```

***

## Mudanças breaking vs. non-breaking

### Mudanças breaking (exigem atualizações de código)

Essas mudanças só ocorrem em atualizações de versão maiores:

* Remoção de um endpoint
* Remoção de um field da resposta
* Remoção de um parâmetro de consulta
* Adição de um novo parâmetro obrigatório
* Alteração do tipo de dados de um field
* Renomeação de um field ou recurso
* Alteração de códigos de resposta ou tipos de erro
* Modificação de escopos de autorização

### Mudanças non-breaking (aditivas)

Estas podem ocorrer a qualquer momento sem alteração de versão:

* Adição de um novo endpoint
* Adição de um novo parâmetro opcional
* Adição de um novo field de resposta
* Adição de novos escopos OAuth
* Alteração do texto da mensagem de erro
* Definição de fields como null por motivos de privacidade/segurança

***

## Cronograma de lançamentos

| Tipo                      | Frequência           | Aviso                              |
| :------------------------ | :------------------- | :--------------------------------- |
| **Versões maiores**       | No máximo anualmente | Guias de migração fornecidos       |
| **Mudanças non-breaking** | Contínuas            | Atualizações no changelog          |
| **Patches de segurança**  | Conforme necessário  | Podem ser aplicados à versão atual |

***

## Política de depreciação

Quando lançamos uma nova versão maior:

1. **Depreciação**: A versão anterior é marcada como depreciada
2. **Período de suporte**: A versão depreciada continua funcionando por um período definido
3. **Retirada**: A versão depreciada é removida

### Definições

| Status         | Significado                                                 |
| :------------- | :---------------------------------------------------------- |
| **Active**     | Totalmente suportada com novos recursos e correções         |
| **Deprecated** | Sem novos recursos; apenas bugs críticos; uso desencorajado |
| **Retired**    | Não mais acessível                                          |

***

## Mantenha-se informado

Seja notificado sobre mudanças:

<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">
    Todas as mudanças e atualizações da plataforma.
  </Card>

  <Card title="Anúncios do Fórum" icon="bullhorn" href="https://devcommunity.x.com/c/announcements/22">
    Avisos de breaking changes.
  </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">
    Notícias e atualizações da 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">
    Resumo mensal.
  </Card>
</CardGroup>

***

## Recursos de migração

Quando uma nova versão é lançada, fornecemos:

* **Guias de migração**: Instruções passo a passo de upgrade
* **Mapeamento de endpoints**: Equivalentes v1 para v2
* **Mudanças de formato de dados**: Diferenças no modelo de objetos

<CardGroup cols={2}>
  <Card title="Visão geral da migração" icon="route" href="/x-api/migrate/overview">
    Orientação atual de migração.
  </Card>

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

***

## Boas práticas

<CardGroup cols={2}>
  <Card title="Use v2" icon="arrow-up">
    Comece novos projetos na versão mais recente.
  </Card>

  <Card title="Monitore anúncios" 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">
    Assine o changelog e as atualizações do fórum.
  </Card>

  <Card title="Teste as mudanças" icon="flask">
    Teste em desenvolvimento antes de atualizações em produção.
  </Card>

  <Card title="Planeje migrações" icon="calendar">
    Não espere até a depreciação para fazer o upgrade.
  </Card>
</CardGroup>