POST /api/v1/submit-with-s3

Альтернативный способ отправки: передать HTTPS-ссылку на PDF (presigned URL из Yandex Object Storage или AWS S3). Сервер скачает документ самостоятельно.

Запрос

POST /api/v1/submit-with-s3
Content-Type: application/json
X-API-Key: ваш-ключ

Параметры (JSON)

Параметр	Тип	По умолчанию	Описание
document_url	string	обязательный	HTTPS-ссылка на PDF-документ
check_graphics	bool	true	Проверять графическую часть (чертежи)
use_ocr	bool	false	OCR для сканированных PDF
use_summary	bool	true	Резюме страниц перед классификацией
use_classification	bool	true	Классификация по разделам ПП-87
classify_from	string	"summary"	Источник классификации: summary или full
requirements_chunk_size	int	5	Требований в одном LLM-запросе (1–20)

document_url обязан начинаться с https://. HTTP-ссылки не принимаются.

Пример

curl -X POST https://your-api/api/v1/submit-with-s3 \
  -H "X-API-Key: ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "document_url": "https://bucket.storage.yandexcloud.net/path/doc.pdf?X-Amz-Signature=...",
    "check_graphics": true,
    "use_ocr": false
  }'

Ответ 200 OK

{
  "task_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "pending",
  "message": "Document submitted for processing. Use the task_id to check status."
}

Ограничения

• Ссылка должна быть доступна без аутентификации или через presigned URL.
• Максимальный размер — 500 МБ.
• Таймаут скачивания — 60 секунд.
• Рекомендуемый TTL presigned URL — не менее 5 минут.

Коды ошибок

Код	Причина
400	URL недоступен, истёк, не PDF или не HTTPS
401	Неверный или отсутствующий API-ключ
413	Файл больше 500 МБ
429	Превышен лимит запросов