Guia de migração para a Account Activity API v2

Este guia ajuda você a migrar da Account Activity API Enterprise legada para a Account Activity API V2. A funcionalidade principal continua a mesma, mas as estruturas de endpoint e os métodos de autenticação foram atualizados para manter consistência com a X API v2.

​

Resumo das mudanças

• Formato da API: os endpoints usam o caminho base /2/account_activity/ em vez de /1.1/account_activity/.
• Gerenciamento de webhooks: a criação, listagem, validação (CRC) e exclusão de webhooks são tratadas pela V2 Webhooks API.
• Autenticação: os endpoints V2 exigem:
  • OAuthUser (OAuth 3-legged) para ações específicas de usuário (por exemplo, assinar um usuário).
  • OAuth2 App Only (Bearer Token) para ações no nível do app (por exemplo, listar/excluir assinaturas).
  • A V1.1 usava requisitos variados, geralmente OAuth 1.0a.
• Mapeamento de endpoints:

• Formatos de resposta: revise as estruturas de resposta de sucesso e erro na documentação da AAAPI.

Ao migrar, atualize seu código para usar os novos caminhos base, ajuste os fluxos de autenticação e gerencie os webhooks usando a V2 Webhooks API.

​

Como migrar

• Escolha um pacote:
  • Escolha o pacote Enterprise ou Self-serve para o acesso à Account Activity API, considerando:
    • Número de webhooks necessários.
    • Assinaturas atuais/projetadas ou usuários autorizados.
    • Número de aplicações cliente do X.
    • Nível de suporte desejado (fórum vs. suporte enterprise gerenciado 1:1).
    • Detalhes de preços (entre em contato com o time de vendas para o Enterprise).
• Atualize sua autenticação para OAuth 2.0:
  • Garanta que o seu X App tenha as permissões “Read, Write, and Access Direct Messages”.
  • Atualize para OAuth 2.0 nos endpoints V2. Reautorize os usuários caso os escopos tenham mudado.
  • Use o Developer Console para gerenciar:
    • Access Token do OAuth 2.0.
    • Client ID e Client Secret.
• Verifique ou reconfigure seu webhook:
  • Use sua URL de webhook existente ou configure uma nova (por exemplo, https://your\_domain.com/webhook/twitter).
  • Siga a documentação da V2 Webhooks API para registrar e gerenciar seu webhook.
• Apps de exemplo:
  • Servidor de webhook simples
    • Um único script Python que mostra como responder à verificação CRC e aceitar eventos POST.
  • Dashboard de exemplo da Account Activity API
    • Um app web escrito com bun.sh que permite gerenciar webhooks, assinaturas e receber eventos ao vivo diretamente no app.