Démarrage rapide

Créer et exécuter une tâche de conformité par lots

Ce guide vous explique pas à pas comment créer un job de conformité par lot afin de vérifier le statut de conformité des Publications ou des utilisateurs.

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 job

   Créez un nouveau job de conformité en spécifiant le type (“tweets” ou “users”) :

   cURL

   curl -X POST "https://api.x.com/2/compliance/jobs" \
     -H "Authorization: Bearer $BEARER_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "type": "tweets",
       "name": "my-compliance-job"
     }'
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/compliance/jobs"
   headers = {
       "Authorization": f"Bearer {bearer_token}",
       "Content-Type": "application/json"
   }
   payload = {
       "type": "tweets",
       "name": "my-compliance-job"
   }
   
   response = requests.post(url, headers=headers, json=payload)
   print(response.json())
   

   Réponse :

   {
     "data": {
       "id": "1234567890",
       "type": "tweets",
       "name": "my-compliance-job",
       "status": "created",
       "upload_url": "https://storage.googleapis.com/...",
       "download_url": "https://storage.googleapis.com/...",
       "created_at": "2024-01-15T10:00:00.000Z"
     }
   }
   

   Enregistrez les valeurs de upload_url et download_url pour les étapes suivantes.

2. Préparer votre fichier de données

   Créez un fichier texte avec un identifiant par ligne :

   1234567890
   1234567891
   1234567892
   1234567893
   

   Enregistrez-le sous ids.txt.

3. Téléverser vos données

   Téléversez le fichier vers l’upload_url fournie :

   curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
     -H "Content-Type: text/plain" \
     --data-binary @ids.txt
   
4. Vérifier l'état du job

   Interrogez périodiquement l’état du job jusqu’à ce qu’il soit terminé :

   curl "https://api.x.com/2/compliance/jobs/1234567890" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   États du job :

   Statut	Description
   created	Job créé, en attente de téléversement
   in_progress	Traitement des données
   complete	Résultats prêts à être téléchargés
   failed	Job ayant échoué
   expired	Job arrivé à expiration avant d’être terminé

5. Télécharger les résultats

   Une fois l’état à complete, téléchargez le fichier à partir de download_url :

   curl "DOWNLOAD_URL_FROM_RESPONSE" -o results.json
   

   Format des résultats (un objet JSON par ligne) :

   {"id": "1234567890", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-12T08:30:00.000Z", "reason": "deleted"}
   {"id": "1234567891", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-13T14:20:00.000Z", "reason": "suspended"}
   

   Seuls les identifiants ayant des événements de conformité apparaissent dans les résultats. Les identifiants qui n’y figurent pas sont toujours valides.

---

​

Actions de conformité

Événements de conformité des Publications

Action	Raison	Description
delete	deleted	La Publication a été supprimée
delete	bounced	La Publication n’a pas passé la vérification de conformité
delete	protected	Le compte est passé en mode protégé
delete	suspended	Le compte a été suspendu
delete	scrub_geo	Les données de géolocalisation ont été supprimées

Événements de conformité des comptes utilisateur

Action	Raison	Description
delete	deleted	Le compte a été supprimé
delete	suspended	Le compte a été suspendu
delete	protected	Le compte est passé en mode protégé
delete	deactivated	Le compte a été désactivé

---

​

Lister toutes les tâches

Récupérez toutes les tâches de conformité pour votre App :

curl "https://api.x.com/2/compliance/jobs?type=tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Prochaines étapes

Guide d’intégration

Concepts clés et bonnes pratiques

Flux de conformité

Événements de conformité en temps réel

Référence de l’API

Documentation complète de l’endpoint