Zum Hauptinhalt springen

​
Leitfaden zur Migration auf die Account Activity API v2

Dieser Leitfaden unterstützt Sie bei der Migration von der älteren Enterprise Account Activity API zur Account Activity API v2. Die Kernfunktionalität bleibt erhalten, jedoch wurden die endpoint-Strukturen und Authentifizierungsmethoden für Konsistenz mit der X API v2 aktualisiert.

​
Zusammenfassung der Änderungen

  • API-Format: Endpoints verwenden den Basispfad /2/account_activity/ statt /1.1/account_activity/.
  • Webhook-Verwaltung: Erstellung, Auflistung, Validierung (CRC) und Löschung von Webhooks werden über die V2 Webhooks API abgewickelt.
  • Authentifizierung: V2-Endpoints erfordern entweder:
    • OAuthUser (3-legged OAuth) für nutzerspezifische Aktionen (z. B. das Abonnieren eines Nutzers).
    • OAuth2 App Only (Bearer Token) für Aktionen auf App-Ebene (z. B. Auflisten/Löschen von Abonnements).
    • V1.1 hatte unterschiedliche Anforderungen, häufig OAuth 1.0a.
  • Endpoint-Zuordnung:
V1.1 EndpointV2-Äquivalent / AktionHinweise
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooksDocs. Erfordert OAuth2AppOnly.
GET /1.1/account_activity/webhooks.jsonGET /2/webhooksDocs. Erfordert OAuth2AppOnly.
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_idLöst CRC aus. Docs. Erfordert OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_idDocs. Erfordert OAuth2AppOnly.
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonPOST /2/account_activity/webhooks/:webhook_id/subscriptions/allErfordert OAuthUser.
GET /1.1/account_activity/subscriptions/count.jsonGET /2/account_activity/subscriptions/countErfordert OAuth2AppOnly.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/allErfordert OAuthUser.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all/listErfordert OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allErfordert OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/allVeraltet / Kein direktes ÄquivalentFühren Sie einzelne Löschvorgänge durch oder entfernen Sie den Webhook über DELETE /2/webhooks/:webhook_id.
  • Response-Formate: Prüfen Sie die Strukturen der Erfolgs- und Fehlerantworten in der AAAPI-Dokumentation.
Bei der Migration aktualisieren Sie Ihren Code auf die neuen Basispfade, passen Sie die Authentifizierungsabläufe an und verwalten Sie Webhooks über die V2 Webhooks API.

​
Vorgehensweise bei der Migration

  • Paket auswählen:
    • Wählen Sie das Enterprise- oder Pro-Paket für den Zugriff auf die Account Activity API und berücksichtigen Sie dabei:
      • Anzahl der benötigten Webhooks.
      • Aktuelle bzw. geplante Abonnements oder autorisierte Nutzer.
      • Anzahl der X-Client-Anwendungen.
      • Gewünschtes Supportniveau (Forum vs. verwalteter Enterprise-1:1-Support).
      • Preisinformationen (für Enterprise den Vertrieb kontaktieren).
  • Ihre Authentifizierung auf OAuth 2.0 aktualisieren:
    • Stellen Sie sicher, dass Ihre X App die Berechtigungen „Read, Write, and Access Direct Messages“ hat.
    • Aktualisieren Sie auf OAuth 2.0 für v2-endpoints. Autorisieren Sie Nutzer erneut, wenn sich die Scopes geändert haben.
    • Verwenden Sie das Entwicklerportal zur Verwaltung von:
      • OAuth 2.0 Access Token.
      • Client ID und Client Secret.
  • Ihren Webhook verifizieren oder neu konfigurieren:
    • Verwenden Sie Ihre bestehende Webhook-URL oder richten Sie eine neue ein (z. B. https://your_domain.com/webhook/twitter).
    • Folgen Sie der V2 Webhooks API documentation, um Ihren Webhook zu registrieren und zu verwalten.
  • Beispiel-Apps:
⌘I