Pular para o conteúdo principal

​
Guia de Migração da 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 permanece a mesma, mas as estruturas de endpoint e os métodos de autenticação foram atualizados para manter a consistência com a X API v2.

​
Resumo das alterações

  • Formato da API: Os endpoints usam o caminho base /2/account_activity/ em vez de /1.1/account_activity/.
  • Gerenciamento de webhooks: Criação, listagem, validação (CRC) e exclusão de webhooks são realizadas pela V2 Webhooks API.
  • Autenticação: Os endpoints da v2 exigem um dos seguintes:
    • OAuthUser (OAuth com 3 etapas) para ações específicas do usuário (por exemplo, inscrever um usuário).
    • OAuth2 App Only (Bearer Token) para ações no nível da App (por exemplo, listar/excluir assinaturas).
    • A v1.1 usava requisitos variados, com frequência OAuth 1.0a.
  • Mapeamento de endpoints:
Endpoint v1.1Equivalente/Ação na v2Observações
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooksDocs. Requer OAuth2AppOnly.
GET /1.1/account_activity/webhooks.jsonGET /2/webhooksDocs. Requer OAuth2AppOnly.
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_idAciona o CRC. Docs. Requer OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_idDocs. Requer OAuth2AppOnly.
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonPOST /2/account_activity/webhooks/:webhook_id/subscriptions/allRequer OAuthUser.
GET /1.1/account_activity/subscriptions/count.jsonGET /2/account_activity/subscriptions/countRequer OAuth2AppOnly.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/allRequer OAuthUser.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all/listRequer OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allRequer OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/allObsoleto / Sem equivalente diretoUse exclusões individuais ou remova o webhook via DELETE /2/webhooks/:webhook_id.
  • Formatos de resposta: Consulte as estruturas de respostas 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 webhooks usando a V2 Webhooks API.

​
Como migrar

  • Decida por um pacote:
    • Escolha o pacote Enterprise ou Pro para acesso à Account Activity API, considerando:
      • Número de webhooks necessários.
      • Assinaturas ou usuários autorizados atuais/projetados.
      • Número de aplicativos clientes do X.
      • Nível de suporte desejado (fórum vs. suporte Enterprise gerenciado 1:1).
      • Detalhes de preços (entre em contato com a equipe de vendas para Enterprise).
  • Atualize sua autenticação para OAuth 2.0:
    • Verifique se sua X App tem as permissões “Read, Write, and Access Direct Messages”.
    • Atualize para OAuth 2.0 para endpoints v2. Reautorize os usuários se os escopos tiverem mudado.
    • Use o portal do desenvolvedor para gerenciar:
      • OAuth 2.0 Access Token.
      • 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 Webhooks API v2 para registrar e gerenciar seu webhook.
  • Apps de exemplo:
⌘I