Passer au contenu principal
L’API Account Activity envoie en temps réel les événements d’activité de compte à votre webhook. Abonnez-vous à des comptes d’utilisateurs et recevez des notifications lorsqu’ils publient, reçoivent des DM, sont suivis, et plus encore.

Vue d’ensemble

Livraison par webhook

Événements livrés à votre serveur

Temps réel

Notifications d’événements instantanées

Complet

Publications, DMs, abonnements, likes et bien plus encore

Par abonnement

Abonnez-vous à des comptes d’utilisateurs

Fonctionnement

  1. Enregistrer le webhook — Enregistrez l’URL de votre webhook
  2. Abonner des utilisateurs — Ajoutez des abonnements pour les utilisateurs
  3. Recevoir des événements — Recevez les événements d’activité via des requêtes POST
  4. Traiter les événements — Traitez les événements dans votre application

Types d’événements

CatégorieÉvénements
PublicationsCréation, suppression, ajout aux favoris, retrait des favoris
Messages privésRéception, envoi, indicateur de saisie
AbonnementsAbonnement, désabonnement
BlocagesBlocage, déblocage
Mises en sourdineMise en sourdine, annulation de la mise en sourdine

Sécurité des webhooks

Toutes les requêtes webhook incluent :
  • Validation CRC — Vérifier l’authenticité du webhook
  • En-tête de signaturex-twitter-webhooks-signature
  • HTTPS requis — Toutes les URL de webhook doivent utiliser HTTPS

Exemple : Enregistrer un webhook

curl -X POST "https://api.x.com/1.1/account_activity/all/env-name/webhooks.json?\
url=https%3A%2F%2Fyour-server.com%2Fwebhook" \
  -H "Authorization: OAuth oauth_consumer_key=..."

Prise en main

Prérequis

Flux d'activité

Alternative en streaming aux webhooks

Guide de migration

Migrer depuis la v1.1

Référence de l’API

Documentation complète des endpoints