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

# واجهة برمجة تطبيقات استعلام مهام WebExtrator

> WebExtrator Web Render & Extract API guide - Ace Data Cloud

`POST https://api.acedata.cloud/webextrator/tasks` （**مجاني**）

استعلام عن مهام `render` / `extract` التاريخية (تُحتفظ بها لمدة 7 أيام).

## استعلام فردي

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

أو عبر `trace_id`:

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

يرجع كائن مهمة واحد (يحتوي على حقول مثل `request` / `response` / `started_at` / `finished_at`).

## استعلام جماعي

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

أو باستخدام `trace_ids`، أو بدون إرسال أي منهما لجلب سجل المهام الخاص بك بشكل مجزأ.

يرجع:

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

## تعريف الحقول

| الحقل                                    | الوصف                                                               |
| ---------------------------------------- | ------------------------------------------------------------------- |
| `id` / `task_id`                         | معرف المهمة الفريد                                                  |
| `trace_id`                               | معرف سلسلة الاستدعاء (متوافق مع PlatformGateway / CLS)              |
| `type`                                   | `render` أو `extract`                                               |
| `request`                                | جسم الطلب الأصلي                                                    |
| `response`                               | نتائج العرض / الاستخراج (مطابقة لحقل `data` في الاستجابة المتزامنة) |
| `started_at` / `finished_at` / `elapsed` | الطوابع الزمنية والمدة (بالثواني)                                   |

> هذه الواجهة مجانية ولا تُحتسب ضمن الاستخدام.