> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jobs asynchrones

> Les endpoints `jobs` mettent les tâches de capture d'écran en file d'attente et permettent de consulter le statut et les résultats — idéal pour un volume élevé ou des captures longues.

## Premiers pas

### URL de base

```
https://screenshot.cleariflow.com/v1/jobs
```

## Créer un job

Mettez en file d'attente une capture d'écran asynchrone avec la même charge utile `ScreenshotRequest` que l'endpoint synchrone.

### Exemple de requête

```bash theme={"system"}
curl -X POST 'https://screenshot.cleariflow.com/v1/jobs' \
  -H 'Content-Type: application/json' \
  -d '{
    "request": {
      "api_key": "YOUR_UNIQUE_API_KEY",
      "url": "https://cleariflow.com"
    },
    "priority": 10
  }'
```

Une requête réussie renvoie un identifiant de job :

<ResponseExample>
  ```json theme={"system"}
  {
    "job_id": "550e8400-e29b-41d4-a716-446655440000"
  }
  ```
</ResponseExample>

### Paramètres de création de job

<ParamField body="request" type="Object" required>
  Un objet `ScreenshotRequest` avec les mêmes champs que l'endpoint synchrone de capture d'écran (`url`, `render`, `actions`, `cookies`, etc.).
</ParamField>

<ParamField body="priority" type="Integer">
  Priorité du job. Les valeurs plus élevées sont traitées en premier. Par défaut : 0.
</ParamField>

## Obtenir le statut d'un job

Interrogez un job par ID pour vérifier son statut et récupérer les résultats une fois terminé.

### URL de base

```
https://screenshot.cleariflow.com/v1/jobs/{job_id}
```

### Exemple de requête

```bash theme={"system"}
curl 'https://screenshot.cleariflow.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000'
```

Pendant l'exécution du job :

<ResponseExample>
  ```json theme={"system"}
  {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "running"
  }
  ```
</ResponseExample>

Lorsque le job se termine avec succès :

<ResponseExample>
  ```json theme={"system"}
  {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "done",
    "result": {
      "ok": true,
      "image_base64": "/9j/4AAQSkZJRg...",
      "content_type": "image/jpeg",
      "meta": {
        "elapsed_ms": 8123
      }
    }
  }
  ```
</ResponseExample>

### Valeurs de statut du job

| Statut    | Description                                         |
| --------- | --------------------------------------------------- |
| `queued`  | Le job attend dans la file d'attente.               |
| `running` | La session de navigateur est active.                |
| `done`    | Capture terminée ; `result` contient la sortie.     |
| `failed`  | Capture échouée ; `error` contient une description. |

### Paramètres de réponse

<ResponseField name="job_id" type="String">
  Identifiant unique du job asynchrone.
</ResponseField>

<ResponseField name="status" type="String">
  Statut actuel du job : `queued`, `running`, `done` ou `failed`.
</ResponseField>

<ResponseField name="result" type="Object">
  L'objet résultat de la capture (même structure que la réponse de l'endpoint synchrone). Présent lorsque `status` est `done`.
</ResponseField>

<ResponseField name="error" type="String">
  Message d'erreur. Présent lorsque `status` est `failed`.
</ResponseField>

<ResponseField name="meta" type="Object">
  Métadonnées supplémentaires sur l'exécution du job.
</ResponseField>