Overview

​

Guida alla migrazione all’Account Activity API v2

Questa guida aiuta a migrare dall’Account Activity API Enterprise legacy all’Account Activity API v2. Le funzionalità principali restano le stesse, ma la struttura degli endpoint e i metodi di autenticazione sono stati aggiornati per garantire coerenza con X API v2.

​

Riepilogo delle modifiche

• Formato API: Gli endpoint utilizzano il percorso base /2/account_activity/ invece di /1.1/account_activity/.
• Gestione dei webhook: Creazione, elenco, convalida (CRC) ed eliminazione dei webhook sono gestite dalla V2 Webhooks API.
• Autenticazione: Gli endpoint v2 richiedono uno dei seguenti:
  • OAuthUser (OAuth a 3 passaggi) per azioni specifiche dell’utente (ad es. iscrivere un utente).
  • OAuth2 App Only (Bearer Token) per azioni a livello di App (ad es. elencare/eliminare iscrizioni).
  • La v1.1 aveva requisiti variabili, spesso OAuth 1.0a.
• Mappatura degli endpoint:

Endpoint v1.1	Equivalente/Azione v2	Note
POST /1.1/account_activity/webhooks.json?url=<URL>	POST /2/webhooks	Docs. Richiede OAuth2AppOnly.
GET /1.1/account_activity/webhooks.json	GET /2/webhooks	Docs. Richiede OAuth2AppOnly.
PUT /1.1/account_activity/webhooks/:webhook_id.json	PUT /2/webhooks/:webhook_id	Attiva il CRC. Docs. Richiede OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id.json	DELETE /2/webhooks/:webhook_id	Docs. Richiede OAuth2AppOnly.
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.json	POST /2/account_activity/webhooks/:webhook_id/subscriptions/all	Richiede OAuthUser.
GET /1.1/account_activity/subscriptions/count.json	GET /2/account_activity/subscriptions/count	Richiede OAuth2AppOnly.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.json	GET /2/account_activity/webhooks/:webhook_id/subscriptions/all	Richiede OAuthUser.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.json	GET /2/account_activity/webhooks/:webhook_id/subscriptions/all/list	Richiede OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all	DELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all	Richiede OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/all	Obsoleto / Nessun equivalente diretto	Usa eliminazioni singole o rimuovi il webhook tramite DELETE /2/webhooks/:webhook_id.

• Formati di risposta: Consulta le strutture delle risposte di successo ed errore nella documentazione AAAPI.

Durante la migrazione, aggiorna il tuo codice per utilizzare i nuovi percorsi base, adegua i flussi di autenticazione e gestisci i webhook utilizzando la V2 Webhooks API.

​

Come eseguire la migrazione

• Scegli un pacchetto:
  • Scegli il pacchetto Enterprise o Pro per l’accesso all’Account Activity API, considerando:
    • Numero di webhook necessari.
    • Abbonamenti o utenti autorizzati attuali/stimati.
    • Numero di applicazioni client X.
    • Livello di supporto desiderato (forum vs supporto Enterprise gestito 1:1).
    • Dettagli sui prezzi (contatta il team vendite per Enterprise).
• Aggiorna l’autenticazione a OAuth 2.0:
  • Assicurati che la tua X App disponga delle autorizzazioni “Read, Write, and Access Direct Messages”.
  • Aggiorna a OAuth 2.0 per gli endpoint v2. Ri‑autorizza gli utenti se gli scope sono cambiati.
  • Usa il developer portal per gestire:
    • OAuth 2.0 Access Token.
    • Client ID e Client Secret.
• Verifica o riconfigura il tuo webhook:
  • Usa il tuo URL di webhook esistente o configurane uno nuovo (ad es. https://your_domain.com/webhook/twitter).
  • Segui la documentazione della Webhooks API v2 per registrare e gestire il tuo webhook.
• App di esempio:
  • Simple webhook server
    • Un singolo script Python che mostra come rispondere al controllo CRC e accettare eventi POST.
  • Account Activity API sample dashboard
    • Una web app sviluppata con bun.sh che consente di gestire webhook, abbonamenti e ricevere eventi in tempo reale direttamente nell’app.