> ## 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.

# WebExtrator API zapytań o zadania

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

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

Zapytanie o historyczne zadania `render` / `extract` (przechowywane przez 7 dni).

## Pojedyncze zapytanie

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

Lub przez `trace_id`:

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

Zwraca pojedynczy obiekt zadania (zawierający pola `request` / `response` / `started_at` / `finished_at` itd.).

## Zapytanie zbiorcze

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

Lub z użyciem `trace_ids`, albo bez podania obu, aby stronicować i pobierać własną historię zadań.

Zwraca:

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

## Definicja pól

| Pole                                     | Opis                                                                  |
| ---------------------------------------- | --------------------------------------------------------------------- |
| `id` / `task_id`                         | Unikalny ID zadania                                                   |
| `trace_id`                               | ID łańcucha wywołań (zgodne z PlatformGateway / CLS)                  |
| `type`                                   | `render` lub `extract`                                                |
| `request`                                | Oryginalne ciało żądania                                              |
| `response`                               | Wynik renderowania / ekstrakcji (to samo co `data` w odpowiedzi sync) |
| `started_at` / `finished_at` / `elapsed` | Znaczniki czasu i czas trwania (w sekundach)                          |

> Ten interfejs jest darmowy i nie jest liczony do zużycia.