Очередь ошибок (DLQ)

Задачи, которые не удалось обработать после всех попыток, попадают в Dead Letter Queue. Вы можете просмотреть их, повторить или удалить.

GET /api/v1/dlq — Список ошибочных задач

GET /api/v1/dlq?limit=100&offset=0
X-API-Key: ваш-ключ

Пример

curl "https://your-api/api/v1/dlq" \
  -H "X-API-Key: ваш-ключ"

Ответ 200 OK

{
  "tasks": [
    {
      "task_id": "dlq-abc-123",
      "original_task_id": "f47ac10b-...",
      "document_name": "проект.pdf",
      "failure_reason": "max_retries_exceeded",
      "error_message": "LLM API returned 503 after 3 attempts",
      "failed_at": "2026-02-18T12:00:00+00:00",
      "retry_count": 3,
      "created_at": "2026-02-18T10:30:00+00:00"
    }
  ],
  "total_count": 1
}

---

POST /api/v1/dlq/{task_id}/retry — Повторить обработку

POST /api/v1/dlq/{task_id}/retry
X-API-Key: ваш-ключ

Пример

curl -X POST https://your-api/api/v1/dlq/dlq-abc-123/retry \
  -H "X-API-Key: ваш-ключ"

Ответ 200 OK

{
  "task_id": "новый-task-id",
  "status": "pending",
  "message": "Task re-submitted for processing"
}

Документ отправляется на повторную обработку с новым task_id. Запись из DLQ удаляется автоматически.

---

DELETE /api/v1/dlq/{task_id} — Удалить из DLQ

DELETE /api/v1/dlq/{task_id}
X-API-Key: ваш-ключ

Пример

curl -X DELETE https://your-api/api/v1/dlq/dlq-abc-123 \
  -H "X-API-Key: ваш-ключ"

Ответ 200 OK

{"message": "Failed task deleted"}

Коды ошибок (все DLQ-эндпоинты)

Код	Причина
401	Неверный или отсутствующий API-ключ
403	Задача принадлежит другому ключу
404	Задача не найдена в DLQ