> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Démarrage rapide
> Créer et exécuter une tâche de conformité par lots
export const Button = ({href, children}) => {
return ;
};
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](https://developer.x.com/en/portal/petition/essential/basic-info) avec une App approuvée
* Du Jeton Bearer de votre App
***
Créez un nouveau job de conformité en spécifiant le type ("tweets" ou "users") :
```bash theme={null}
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 theme={null}
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 :**
```json theme={null}
{
"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.
Créez un fichier texte avec un identifiant par ligne :
```
1234567890
1234567891
1234567892
1234567893
```
Enregistrez-le sous `ids.txt`.
Téléversez le fichier vers l'`upload_url` fournie :
```bash theme={null}
curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
-H "Content-Type: text/plain" \
--data-binary @ids.txt
```
Interrogez périodiquement l'état du job jusqu'à ce qu'il soit terminé :
```bash theme={null}
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é |
Une fois l'état à `complete`, téléchargez le fichier à partir de `download_url` :
```bash theme={null}
curl "DOWNLOAD_URL_FROM_RESPONSE" -o results.json
```
**Format des résultats** (un objet JSON par ligne) :
```json theme={null}
{"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é
| 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 |
| 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 :
```bash theme={null}
curl "https://api.x.com/2/compliance/jobs?type=tweets" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
***
## Prochaines étapes
Concepts clés et bonnes pratiques
Événements de conformité en temps réel
Documentation complète de l’endpoint