> ## 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.
# Inicio rápido
> Crea y ejecuta un trabajo de cumplimiento por lotes
export const Button = ({href, children}) => {
return ;
};
Esta guía te muestra cómo crear un trabajo de cumplimiento por lotes para verificar el estado de cumplimiento de Publicaciones o usuarios.
**Requisitos previos**
Antes de comenzar, necesitarás:
* Una [cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) con una App aprobada
* El Bearer Token de tu App
***
Crea un nuevo trabajo de cumplimiento especificando el campo `type` (`tweets` o `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())
```
**Respuesta:**
```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"
}
}
```
Guarda los valores de `upload_url` y `download_url` para los siguientes pasos.
Crea un archivo de texto con un ID por línea:
```
1234567890
1234567891
1234567892
1234567893
```
Guárdalo como `ids.txt`.
Sube el archivo a la `upload_url` proporcionada:
```bash theme={null}
curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
-H "Content-Type": text/plain" \
--data-binary @ids.txt
```
Consulta periódicamente el estado del trabajo hasta que se complete:
```bash theme={null}
curl "https://api.x.com/2/compliance/jobs/1234567890" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
**Estados del trabajo:**
| Estado | Descripción |
| :------------ | :------------------------------------- |
| `created` | Trabajo creado, en espera de la carga |
| `in_progress` | Procesando los datos |
| `complete` | Resultados listos para su descarga |
| `failed` | El trabajo falló |
| `expired` | El trabajo expiró antes de completarse |
Una vez que el estado sea `complete`, descarga desde `download_url`:
```bash theme={null}
curl "DOWNLOAD_URL_FROM_RESPONSE" -o results.json
```
**Formato del resultado** (un objeto JSON por línea):
```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"}
```
Solo los ID con eventos de cumplimiento aparecen en los resultados. Los ID que no aparezcan en los resultados siguen siendo válidos.
***
## Acciones de cumplimiento
| Acción | Motivo | Descripción |
| :------- | :---------- | :------------------------------------------------------- |
| `delete` | `deleted` | La Publicación fue eliminada |
| `delete` | `bounced` | La Publicación no superó la verificación de cumplimiento |
| `delete` | `protected` | La cuenta pasó a ser protegida |
| `delete` | `suspended` | La cuenta fue suspendida |
| `delete` | `scrub_geo` | Se eliminaron los datos de geolocalización |
| Acción | Motivo | Descripción |
| :------- | :------------ | :----------------------------- |
| `delete` | `deleted` | La cuenta fue eliminada |
| `delete` | `suspended` | La cuenta fue suspendida |
| `delete` | `protected` | La cuenta pasó a ser protegida |
| `delete` | `deactivated` | La cuenta fue desactivada |
***
## Enumerar todos los trabajos
Obtén todos los trabajos de cumplimiento de tu App:
```bash theme={null}
curl "https://api.x.com/2/compliance/jobs?type=tweets" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
***
## Próximos pasos
Conceptos clave y mejores prácticas
Eventos de cumplimiento en tiempo real
Documentación completa de los endpoints