> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Загрузить документ

> Загрузить лабораторный отчёт или любой другой документ в профиль и при необходимости извлечь из него лабораторные показатели

Загрузи один файл в профиль. Отправь его как `multipart/form-data`. Без `extract_results` Aniva
только сохраняет файл. С `extract_results: true` Aniva также считывает лабораторные значения из
файла.

Тебе не нужно указывать тип отчета. Aniva определяет его сама. Файл без лабораторных результатов,
например выписка врача, получает статус `stored` — это не ошибка.

Значения читай через [Получение результатов документа](https://docs.anivahealth.com/ru/api/documents/get-document-results.md).
Постоянно опрашивать API не нужно: подпишись на [вебхуки](https://docs.anivahealth.com/ru/concepts/webhooks.md)
`document.results.*`.

Требуется разрешение `documents_upload` для группы профилей, в которую входит профиль. Для
`extract_results: true` также требуется разрешение `documents_extract_results` в той же группе.
Попроси Aniva добавить их. Документ принадлежит этой группе: ключи с `results_view` для нее могут
читать документ и его результаты.

Отправь необязательный заголовок `Idempotency-Key`, чтобы загрузку можно было безопасно повторить.
См. [Идемпотентность](https://docs.anivahealth.com/ru/concepts/idempotency.md).

## Что делает извлечение

При `extract_results: true`:

1. Aniva отправляет файл своим субподрядчикам по OCR и ИИ, чтобы считать значения.
2. Значения появляются в приложении Aniva участника, как и любой другой результат.
3. У каждого значения указано `origin: partner_upload` и тот же `status`, что и у любого другого результата.
   Значение, в котором сомневается автоматическая проверка Aniva, получает статус `likely_wrong`.

Без него файл не передаётся никаким внешним сервисам, если ты также отправляешь `document_date`.

> [accordion] Точность и защита данных
>
> * Автоматическое считывание может ошибиться в значении, единице измерения или дате. Исходный файл
>   остаётся первоисточником. Сверяй значение с ним перед тем, как использовать его для медицинского
>   решения. Извлечённые значения не являются диагнозом.
> * Субподрядчики — Mistral AI (OCR, ЕС) и Google Cloud Vertex AI через Vercel AI Gateway
>   (извлечение, обработка может проходить за пределами ЕС). Они обрабатывают файл только для
>   считывания.
> * Для загрузки данных о здоровье участника тебе нужно правовое основание, обычно явное согласие
>   участника. За это отвечаешь ты.

## Запрос

### Поля формы

**file** `file` *required*

Файл. PDF, DOC, DOCX, PNG или JPEG, не более 4 MB.

**profile\_id** `string` *required*

UUID профиля, которому принадлежит документ.

**extract\_results** `boolean` (default: false)

`true`, чтобы считать лабораторные значения из файла. Отправляй `true` или `false`.

**document\_date** `string`

Дата взятия образца в формате `YYYY-MM-DD`, если ты её знаешь. Без неё Aniva считывает дату из
файла.

## Ответ

API возвращает `201 Created`, если файл только сохранён, и `202 Accepted`, если запущено извлечение.

**id** `string` *required*

ID документа (UUID). Используй его в [Получить результаты документа](https://docs.anivahealth.com/ru/api/documents/get-document-results.md) и
[Скачать документ](https://docs.anivahealth.com/ru/api/documents/download-document.md).

**status** `string` *required*

`processing`, пока Aniva извлекает значения, или `stored`, когда файл только сохранён.

**profile\_id** `string` *required*

Профиль, которому принадлежит документ.

**document\_date** `string`

Отправленная тобой дата взятия образца или дата, которую Aniva считала из сохранённого файла. Может быть `null`.

**results\_url** `string` *required*

URL [Получить результаты документа](https://docs.anivahealth.com/ru/api/documents/get-document-results.md) для этого документа.

**file\_name** `string` *required*

Имя файла для отображения — то же, что отправляет [Скачать документ](https://docs.anivahealth.com/ru/api/documents/download-document.md).

**original\_file\_name** `string` *required*

Имя загруженного тобой файла.

**origin** `string` *required*

Всегда `partner_upload`.

**content\_type** `string` *required*

Медиатип файла, например `application/pdf`.

**etag** `string`

Версия содержимого файла. Может быть `null`.

**size\_bytes** `integer`

Размер файла в байтах. Может быть `null`.

**lab\_code** `string`

Всегда `null` для загруженного документа.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | Поле формы некорректно или тело запроса не в формате `multipart/form-data`. |
| `403` | У твоего API-ключа нет нужного разрешения, профиль вне твоего контекста доступа или отправлено `extract_results: true` без `documents_extract_results`. |
| `404` | Профиль не найден. |
| `409` | `duplicate_document`: такой же файл уже есть в этом профиле. В `document_id` указан его ID, или `null`, если у тебя нет доступа на чтение. Также возвращается при конфликте `Idempotency-Key`. |
| `413` | `file_too_large`: файл больше 4 MB. |
| `415` | `unsupported_media_type`: файл не в формате PDF, DOC, DOCX, PNG или JPEG. Имя файла должно заканчиваться на `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` или `.jpeg`. |
| `500` | Внутренняя ошибка сервера. `extraction_not_started`: файл сохранён под `document_id`, но запустить извлечение не удалось. Свяжись с Aniva. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/documents \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Idempotency-Key: 5f0c2d9e-3b7a-4c1e-9f62-1d8a4e7b0c55' \
  --form 'file=@lab-report.pdf' \
  --form 'profile_id=b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e' \
  --form 'extract_results=true'
```

```json 202 theme={null}
{
  "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
  "status": "processing",
  "profile_id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
  "document_date": null,
  "results_url": "https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results",
  "file_name": "20261023 - lab-report.pdf",
  "original_file_name": "lab-report.pdf",
  "origin": "partner_upload",
  "content_type": "application/pdf",
  "etag": "56104b36f860cfd5b41efc716fdf7b6f",
  "size_bytes": 312480,
  "lab_code": null
}
```

```json 409 theme={null}
{
  "error": "duplicate_document",
  "message": "This file is already on this profile",
  "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.