GET /api/v1/status/{task_id}

Возвращает текущий статус задачи, прогресс и прогноз времени завершения.

Запрос

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

Пример

curl https://your-api/api/v1/status/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "X-API-Key: ваш-ключ"

Ответ 200 OK

{
  "task_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "running",
  "document_name": "проект.pdf",
  "created_at": "2026-02-18T10:30:00+00:00",
  "updated_at": "2026-02-18T10:32:15+00:00",
  "current_stage": "review_text",
  "progress_percent": 65.0,
  "stages": [
    {"stage_name": "extract_text", "status": "completed", "elapsed_sec": 2.1},
    {"stage_name": "summarize", "status": "completed", "elapsed_sec": 45.3},
    {"stage_name": "classify", "status": "completed", "elapsed_sec": 8.7},
    {"stage_name": "review_text", "status": "running", "elapsed_sec": 30.0}
  ],
  "has_result": false,
  "current_stages": [
    {"stage": "review_text", "eta_sec": 120.5, "confidence": 0.75, "is_parallel": true, "branch": "text"},
    {"stage": "graphics_detect", "eta_sec": 15.0, "confidence": 0.6, "is_parallel": true, "branch": "graphics"}
  ],
  "total_eta_sec": 135.5,
  "total_confidence": 0.7,
  "estimated_completion": "2026-02-18T10:34:30+00:00"
}

Поля ответа

Поле	Описание
status	Текущий статус задачи
document_name	Имя загруженного файла
created_at	Время создания задачи (ISO 8601)
updated_at	Время последнего обновления статуса (ISO 8601)
progress_percent	Процент выполнения (0–100)
has_result	true, если результат доступен
current_stage	Название текущего этапа
stages	Список всех этапов с их статусами
current_stages	Прогноз по активным этапам (несколько при параллельной обработке)
total_eta_sec	Оценка оставшегося времени в секундах
total_confidence	Уверенность в прогнозе (0.0–1.0)
estimated_completion	Прогнозируемое время завершения (ISO 8601)

Значения status

Статус	Описание
pending	В очереди, ожидает обработки
running	Обрабатывается
completed	Готово, результат доступен
failed	Ошибка при обработке
cancelled	Отменена пользователем

Коды ошибок

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