> ## Documentation Index
> Fetch the complete documentation index at: https://germeytechnology-docs-remove-4o-image-nav.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API de requête des tâches WebExtrator

> WebExtrator Web Render & Extract 集成指南 - Ace Data Cloud

`POST https://api.acedata.cloud/webextrator/tasks` (**Gratuit**)

Interroger les tâches historiques `render` / `extract` (conservées pendant 7 jours).

## Requête unique

```json theme={null}
{
  "action": "retrieve",
  "id": "550e8400-e29b-41d4-a716-446655440000"
}
```

Ou via `trace_id` :

```json theme={null}
{
  "action": "retrieve",
  "trace_id": "550e8400-e29b-41d4-a716-446655440001"
}
```

Retourne un objet tâche unique (incluant les champs `request` / `response` / `started_at` / `finished_at`, etc.).

## Requête en lot

```json theme={null}
{
  "action": "retrieve_batch",
  "ids": ["...", "..."],
  "limit": 12,
  "offset": 0
}
```

Ou avec `trace_ids`, ou sans transmettre ni l’un ni l’autre pour paginer l’historique de ses propres tâches.

Retour :

```json theme={null}
{
  "items": [ { /* task */ }, ... ],
  "count": 2
}
```

## Définition des champs

| Champ                                    | Description                                                                   |
| ---------------------------------------- | ----------------------------------------------------------------------------- |
| `id` / `task_id`                         | ID unique de la tâche                                                         |
| `trace_id`                               | ID de la chaîne d’appel (aligné avec PlatformGateway / CLS)                   |
| `type`                                   | `render` ou `extract`                                                         |
| `request`                                | Corps de la requête d’origine                                                 |
| `response`                               | Résultat du rendu / extraction (identique au champ `data` de la réponse sync) |
| `started_at` / `finished_at` / `elapsed` | Horodatages et durée (en secondes)                                            |

> Cette API est gratuite et ne compte pas dans la consommation.