Управление задачами

GET /api/v1/tasks — Список задач

Возвращает все задачи текущего пользователя (по API-ключу).

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

Параметры запроса

Параметр	Тип	По умолчанию	Описание
limit	int	100	Количество задач на странице
offset	int	0	Смещение для пагинации

Пример

curl "https://your-api/api/v1/tasks?limit=10" \
  -H "X-API-Key: ваш-ключ"

Ответ 200 OK

{
  "tasks": [
    {
      "task_id": "f47ac10b-...",
      "status": "completed",
      "document_name": "проект.pdf",
      "created_at": "2026-02-18T10:30:00+00:00",
      "progress_percent": 100.0,
      "has_result": true
    }
  ],
  "total_count": 1
}

Коды ошибок

Код	Причина
401	Неверный или отсутствующий API-ключ

---

DELETE /api/v1/tasks/{task_id} — Отмена задачи

Отменяет задачу в статусе pending или running.

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

Пример

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

Ответ 200 OK

{"message": "Task cancelled"}

Нельзя отменить задачу в статусе completed или failed.

Коды ошибок

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