Démarrage rapide

Configurer des abonnements aux flux d’activité et recevoir des événements

Ce guide vous explique comment configurer des abonnements au flux d’activité afin de recevoir en temps réel les événements d’activité de compte.

Prérequis

Avant de commencer, vous aurez besoin :

• D’un compte développeur avec une App approuvée
• Du Jeton Bearer de votre App

---

1. Créer un abonnement

   Abonnez-vous aux événements d’activité d’un utilisateur :

   cURL

   curl -X POST "https://api.x.com/2/activity/subscriptions" \
     -H "Authorization: Bearer $BEARER_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
     }'
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/activity/subscriptions"
   headers = {
       "Authorization": f"Bearer {bearer_token}",
       "Content-Type": "application/json"
   }
   payload = {
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
   }
   
   response = requests.post(url, headers=headers, json=payload)
   print(response.json())
   

   Réponse :

   {
     "data": {
       "id": "1234567890",
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"],
       "created_at": "2024-01-15T10:00:00.000Z"
     }
   }
   
2. Se connecter au flux

   Ouvrez une connexion persistante pour recevoir les événements :

   cURL

   curl "https://api.x.com/2/activity/stream" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/activity/stream"
   headers = {"Authorization": f"Bearer {bearer_token}"}
   
   response = requests.get(url, headers=headers, stream=True)
   
   for line in response.iter_lines():
       if line:
           print(line.decode("utf-8"))
   
3. Traiter les événements entrants

   Les événements sont diffusés sous forme d’objets JSON :

   {
     "for_user_id": "2244994945",
     "event_type": "tweet_create_events",
     "created_at": "2024-01-15T10:30:00.000Z",
     "tweet_create_events": [
       {
         "id": "1234567890",
         "text": "Hello from the stream!",
         "author_id": "2244994945"
       }
     ]
   }
   

---

​

Types d’événements disponibles

Événement	Description
tweet_create_events	Un utilisateur publie une nouvelle publication
favorite_events	Un utilisateur aime une publication
follow_events	Un utilisateur suit un autre utilisateur ou est suivi
direct_message_events	Un utilisateur envoie ou reçoit un DM
block_events	Un utilisateur bloque ou débloque un autre utilisateur
mute_events	Un utilisateur met un autre utilisateur en sourdine ou annule la mise en sourdine

---

​

Gérer les abonnements

Afficher les abonnements

Obtenez tous les abonnements actifs :

curl "https://api.x.com/2/activity/subscriptions" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Mettre à jour un abonnement

Modifier les types d’événements d’un abonnement :

curl -X PUT "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_types": ["tweet_create_events", "favorite_events"]
  }'

Supprimer un abonnement

Supprimer un abonnement :

curl -X DELETE "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Prochaines étapes

Account Activity API

Alternative reposant sur des webhooks

Référence de l’API

Documentation complète du point de terminaison