> ## 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.

# Nahrát dokument

> Nahrát laboratorní zprávu nebo jakýkoli jiný dokument do profilu a volitelně z něj extrahovat laboratorní hodnoty

Nahraj jeden soubor do profilu. Pošli ho jako `multipart/form-data`. Bez `extract_results` Aniva soubor jen
uloží. S `extract_results: true` z něj Aniva také vyčte laboratorní hodnoty.

Nemusíš uvádět, o jaký typ zprávy jde. Rozhodne o tom Aniva. Soubor bez laboratorních výsledků, například
lékařská zpráva, skončí ve stavu `stored` a není to chyba.

Hodnoty načti pomocí [Získat výsledky dokumentu](https://docs.anivahealth.com/cs/api/documents/get-document-results.md). Nemusíš dělat
polling: přihlas se k odběru [webhooků](https://docs.anivahealth.com/cs/concepts/webhooks.md) `document.results.*`.

Vyžaduje scope `documents_upload` pro skupinu profilů daného profilu. `extract_results: true`
také vyžaduje scope `documents_extract_results` pro stejnou skupinu. O jejich přidání požádej Anivu. Dokument
patří do této skupiny: klíče se scope `results_view` pro tuto skupinu mohou číst dokument i jeho výsledky.

Pošli volitelnou hlavičku `Idempotency-Key`, aby šlo nahrání bezpečně opakovat. Viz
[Idempotence](https://docs.anivahealth.com/cs/concepts/idempotency.md).

## Co dělá extrakce

S `extract_results: true`:

1. Aniva pošle soubor svým dílčím zpracovatelům pro OCR a AI, aby přečetli hodnoty.
2. Hodnoty se zobrazí v aplikaci Aniva daného člena stejně jako každý jiný výsledek.
3. Každá hodnota má `origin: partner_upload` a stejný `status` jako každý jiný výsledek. Hodnota,
   o které automatická kontrola Aniva pochybuje, má stav `likely_wrong`.

Bez toho se soubor neposílá žádné externí službě, pokud zároveň pošleš `document_date`.

> [accordion] Přesnost a ochrana dat
>
> * Automatické čtení může špatně přečíst hodnotu, jednotku nebo datum. Původní soubor zůstává
>   zdrojem pravdy. Než hodnotu použiješ pro lékařské rozhodnutí, ověř ji podle něj. Extrahované
>   hodnoty nejsou diagnóza.
> * Dílčími zpracovateli jsou Mistral AI (OCR, EU) a Google Cloud Vertex AI dostupný přes Vercel
>   AI Gateway (extrakce, může zpracovávat mimo EU). Soubor zpracovávají jen proto, aby ho
>   přečetli.
> * K nahrání zdravotních údajů člena potřebuješ právní základ, obvykle jeho výslovný souhlas.
>   Zodpovídáš za něj.

## Požadavek

### Pole formuláře

**file** `file` *required*

Soubor. PDF, DOC, DOCX, PNG nebo JPEG, maximálně 4 MB.

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

UUID profilu, ke kterému dokument patří.

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

`true` pro přečtení laboratorních hodnot ze souboru. Pošli `true` nebo `false`.

**document\_date** `string`

Datum odběru ve formátu `YYYY-MM-DD`, pokud ho znáš. Bez něj Aniva přečte datum ze
souboru.

## Odpověď

API vrátí `201 Created`, když soubor jen uložilo, a `202 Accepted`, když běží extrakce.

**id** `string` *required*

ID dokumentu (UUID). Použij ho pro [Získat výsledky dokumentu](https://docs.anivahealth.com/cs/api/documents/get-document-results.md) a
[Stáhnout dokument](https://docs.anivahealth.com/cs/api/documents/download-document.md).

**status** `string` *required*

`processing`, dokud Aniva extrahuje hodnoty, nebo `stored`, když je soubor jen uložený.

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

Profil, ke kterému dokument patří.

**document\_date** `string`

Odeslané datum odběru nebo datum, které Aniva přečetla z uloženého souboru. Může být `null`.

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

URL [Získat výsledky dokumentu](https://docs.anivahealth.com/cs/api/documents/get-document-results.md) pro tento dokument.

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

Název souboru pro zobrazení, stejný, jaký posílá [Stáhnout dokument](https://docs.anivahealth.com/cs/api/documents/download-document.md).

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

Název nahraného souboru.

**origin** `string` *required*

Vždy `partner_upload`.

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

Typ média souboru, např. `application/pdf`.

**etag** `string`

Verze obsahu souboru. Může být `null`.

**size\_bytes** `integer`

Velikost souboru v bajtech. Může být `null`.

**lab\_code** `string`

U nahraného dokumentu vždy `null`.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Pole formuláře je neplatné nebo tělo není `multipart/form-data`. |
| `403` | Tvému API klíči chybí scope, profil je mimo tvůj přístupový kontext nebo posíláš `extract_results: true` bez `documents_extract_results`. |
| `404` | Profil nenalezen. |
| `409` | `duplicate_document`: stejný soubor už u tohoto profilu je. `document_id` ho označuje, nebo je `null`, když ho nemůžeš číst. Posílá se také při konfliktu `Idempotency-Key`. |
| `413` | `file_too_large`: soubor má více než 4 MB. |
| `415` | `unsupported_media_type`: soubor není PDF, DOC, DOCX, PNG ani JPEG. Název souboru musí končit na `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` nebo `.jpeg`. |
| `500` | Interní chyba serveru. `extraction_not_started`: soubor je uložený jako `document_id`, ale extrakci se nepodařilo spustit. Kontaktuj 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.