Быстрый старт
Публичный API пока недоступен для подключения. Ниже — пример отправки файла и параметров обработки одним запросом; точные поля и ответы смотрите в справочнике API.
1. Создайте API-ключ
Создайте ключ в личном кабинете и храните его как секрет. Запросы к API выполняются с сервера — не размещайте ключ в браузерном коде.
2. Отправьте файл на обработку
Файл и параметры обработки можно передать вместе в multipart/form-data:
curl --request POST 'https://lissa.health/api/v1/documents' \
--header 'Authorization: Bearer <API_KEY>' \
--form 'file=@report.pdf;type=application/pdf' \
--form 'request={"idempotency_key":"report-001","wait_seconds":5,"features":["text","biomarkers"]};type=application/json'idempotency_key передаётся в JSON-теле и должен оставаться тем же при повторе той же операции. wait_seconds задаёт ограниченное ожидание: 0 возвращает задание сразу, а значение 1–10 может вернуть готовый результат. Если обработка не завершилась за это время, ответ содержит задание.
Если файл уже загружен через POST /api/v1/files, его можно передать по file_id в JSON-запросе:
POST /api/v1/documents
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"file": {
"file_id": "file_..."
},
"idempotency_key": "report-001",
"wait_seconds": 5,
"features": ["text", "biomarkers"]
}3. Получите результат
При ответе 202 проверьте состояние через GET /api/v1/jobs/{job_id}. Когда результат будет доступен, получите его через GET /api/v1/jobs/{job_id}/result. При сетевом таймауте повторите исходный POST с тем же idempotency_key.
Подробные параметры и форматы ответов доступны в справочнике API.