Passer au contenu principal
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 V2Notes
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooksDocs. Nécessite OAuth2AppOnly.
GET /1.1/account_activity/webhooks.jsonGET /2/webhooksDocs. Nécessite OAuth2AppOnly.
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_idDéclenche le CRC. Docs. Nécessite OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_idDocs. Nécessite OAuth2AppOnly.
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonPOST /2/account_activity/webhooks/:webhook_id/subscriptions/allNécessite OAuthUser.
GET /1.1/account_activity/subscriptions/count.jsonGET /2/account_activity/subscriptions/countNécessite OAuth2AppOnly.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/allNécessite OAuthUser.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all/listNécessite OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allNécessite OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/allObsolète / aucun équivalent directUtilisez 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 :