Guide de migration de l’API Account Activity v2

Ce guide vous aide à migrer de l’ancienne Enterprise Account Activity API vers la v2 Account Activity API. La fonctionnalité de base reste la même, mais la structure des endpoints et les méthodes d’authentification ont été mises à jour pour être cohérentes avec X API v2.

​

Récapitulatif des changements

• Format de l’API : les endpoints utilisent le chemin de base /2/account_activity/ au lieu de /1.1/account_activity/.
• Gestion des webhooks : la création, la consultation, la validation (CRC) et la suppression des webhooks sont gérées par la V2 Webhooks API.
• Authentification : les endpoints V2 nécessitent l’un des modes suivants :
  • OAuthUser (OAuth à 3 volets) pour les actions spécifiques à un utilisateur (par exemple, abonner un utilisateur).
  • OAuth2 App Only (Jeton Bearer) pour les actions au niveau de l’App (par exemple, lister/supprimer des abonnements).
  • V1.1 utilisait des exigences variables, souvent OAuth 1.0a.
• Correspondance des endpoints :

Endpoint V1.1	Équivalent / action V2	Notes
POST /1.1/account_activity/webhooks.json?url=<URL>	POST /2/webhooks	Docs. Nécessite OAuth2AppOnly.
GET /1.1/account_activity/webhooks.json	GET /2/webhooks	Docs. Nécessite OAuth2AppOnly.
PUT /1.1/account_activity/webhooks/:webhook_id.json	PUT /2/webhooks/:webhook_id	Déclenche le CRC. Docs. Nécessite OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id.json	DELETE /2/webhooks/:webhook_id	Docs. Nécessite OAuth2AppOnly.
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.json	POST /2/account_activity/webhooks/:webhook_id/subscriptions/all	Nécessite OAuthUser.
GET /1.1/account_activity/subscriptions/count.json	GET /2/account_activity/subscriptions/count	Nécessite OAuth2AppOnly.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.json	GET /2/account_activity/webhooks/:webhook_id/subscriptions/all	Nécessite OAuthUser.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.json	GET /2/account_activity/webhooks/:webhook_id/subscriptions/all/list	Nécessite OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all	DELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all	Nécessite OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/all	Obsolète / aucun équivalent direct	Utilisez des suppressions individuelles ou supprimez le webhook via DELETE /2/webhooks/:webhook_id.

• Formats de réponse : consultez les structures des réponses en cas de réussite et d’erreur dans la documentation AAAPI.

Lors de la migration, mettez à jour votre code pour utiliser les nouveaux chemins de base, adaptez les flux d’authentification et gérez les webhooks à l’aide de la V2 Webhooks API.

​

Comment migrer

• Choisir un forfait :
  • Choisissez le forfait Enterprise ou Self-serve en self-service pour l’accès à l’Account Activity API, en tenant compte des éléments suivants :
    • Nombre de webhooks nécessaires.
    • Nombre actuel/prévisionnel d’abonnements ou d’utilisateurs autorisés.
    • Nombre d’applications X clientes.
    • Niveau de support souhaité (forum vs. support Enterprise géré 1:1).
    • Détails de tarification (contactez l’équipe commerciale pour Enterprise).
• Mettre à jour votre authentification vers OAuth 2.0 :
  • Assurez-vous que votre App X dispose des autorisations « Read, Write, and Access Direct Messages ».
  • Mettez à jour vers OAuth 2.0 pour les endpoints V2. Réautorisez les utilisateurs si les scopes ont changé.
  • Utilisez la Console de développement pour gérer :
    • OAuth 2.0 Access Token.
    • Client ID et Client Secret.
• Vérifier ou reconfigurer votre webhook :
  • Utilisez votre URL de webhook existante ou configurez-en une nouvelle (par exemple, https://your_domain.com/webhook/twitter).
  • Suivez la documentation V2 Webhooks API pour enregistrer et gérer votre webhook.
• Exemples d’applications :
  • Serveur de webhook simple
    • Un seul script Python qui montre comment répondre au contrôle CRC et accepter des événements POST.
  • Tableau de bord d’exemple Account Activity API
    • Une application web écrite avec bun.sh qui vous permet de gérer les webhooks, les abonnements et de recevoir des événements en temps réel directement dans l’application.