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

# Dokumentum feltöltése

> Laborlelet vagy bármilyen más dokumentum feltöltése egy profilhoz, és opcionálisan a laborértékek kinyerése

Tölts fel egy fájlt egy profilhoz. Küldd `multipart/form-data` formátumban. Az `extract_results` nélkül
az Aniva csak tárolja a fájlt. Az `extract_results: true` megadásával az Aniva a laborértékeket is kiolvassa a fájlból.

Nem kell megadnod, milyen típusú lelet a fájl. Az Aniva dönti el. A laboreredményeket nem tartalmazó
fájl, például egy orvosi levél, `stored` állapotban zárul, és nem számít hibának.

Olvasd le az értékeket a [Dokumentum eredményeinek lekérése](https://docs.anivahealth.com/hu/api/documents/get-document-results.md) segítségével. Nem kell
folyamatosan lekérdezned: iratkozz fel a `document.results.*` [webhookokra](https://docs.anivahealth.com/hu/concepts/webhooks.md).

A `documents_upload` scope szükséges hozzá a profil egyik profilcsoportján. Az `extract_results: true`
a `documents_extract_results` scope-ot is igényli ugyanazon a csoporton. Kérd meg az Anivát, hogy
adja hozzá ezeket. A dokumentum ehhez a csoporthoz tartozik: a rajta `results_view` scope-pal rendelkező
kulcsok olvashatják a dokumentumot és az eredményeit.

Küldj egy opcionális `Idempotency-Key` fejlécet, hogy a feltöltés biztonságosan újrapróbálható legyen. Lásd:
[Idempotencia](https://docs.anivahealth.com/hu/concepts/idempotency.md).

## Mit csinál a kinyerés

Az `extract_results: true` megadásával:

1. Az Aniva elküldi a fájlt az OCR- és AI-aladatfeldolgozóinak, hogy kiolvassák az értékeket.
2. Az értékek megjelennek a tag Aniva alkalmazásában, mint minden más eredmény.
3. Minden érték `origin: partner_upload` jelölést és ugyanazt a `status` mezőt kapja, mint minden más eredmény. Amelyik értéket
   az Aniva automatikus ellenőrzése kétségbe vonja, annak `likely_wrong` a státusza.

Enélkül a fájl egyetlen külső szolgáltatáshoz sem kerül, ha a `document_date` mezőt is elküldöd.

> [accordion] Pontosság és adatvédelem
>
> * Az automatikus kiolvasás félreolvashat egy értéket, mértékegységet vagy dátumot. Az eredeti fájl marad az irányadó
>   forrás. Vesd össze vele az értéket, mielőtt orvosi döntéshez használod. A kiolvasott értékek
>   nem minősülnek diagnózisnak.
> * Az aladatfeldolgozók a Mistral AI (OCR, EU) és a Google Cloud Vertex AI, a Vercel AI Gateway-en
>   keresztül elérve (kiolvasás, az EU-n kívül is feldolgozhat). A fájlt kizárólag a kiolvasás
>   céljából dolgozzák fel.
> * Egy tag egészségügyi adatainak feltöltéséhez jogalapra van szükséged, általában a tag kifejezett
>   hozzájárulására. Ez a te felelősséged.

## Kérés

### Űrlapmezők

**file** `file` *required*

A fájl. PDF, DOC, DOCX, PNG vagy JPEG, legfeljebb 4 MB.

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

Annak a profilnak az UUID-je, amelyhez a dokumentum tartozik.

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

`true` a laborértékek fájlból való kiolvasásához. Küldj `true` vagy `false` értéket.

**document\_date** `string`

A mintavétel dátuma `YYYY-MM-DD` formátumban, ha ismered. Enélkül az Aniva kiolvassa a dátumot a
fájlból.

## Válasz

Az API `201 Created` választ ad vissza, ha csak tárolta a fájlt, és `202 Accepted` választ, ha a kiolvasás fut.

**id** `string` *required*

Dokumentumazonosító (UUID). Használd a [Dokumentum eredményeinek lekérése](https://docs.anivahealth.com/hu/api/documents/get-document-results.md) és a
[Dokumentum letöltése](https://docs.anivahealth.com/hu/api/documents/download-document.md) végpontokkal.

**status** `string` *required*

`processing`, amíg az Aniva kiolvassa az értékeket, vagy `stored`, ha a fájlt csak tárolta.

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

A profil, amelyhez a dokumentum tartozik.

**document\_date** `string`

Az általad küldött mintavételi dátum, vagy amelyet az Aniva egy tárolt fájlból olvasott ki. Lehet `null`.

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

A dokumentum [Dokumentum eredményeinek lekérése](https://docs.anivahealth.com/hu/api/documents/get-document-results.md) URL-je.

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

Megjelenítendő fájlnév, ugyanaz, amelyet a [Dokumentum letöltése](https://docs.anivahealth.com/hu/api/documents/download-document.md) küld.

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

Az általad feltöltött fájlnév.

**origin** `string` *required*

Mindig `partner_upload`.

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

A fájl médiatípusa, pl. `application/pdf`.

**etag** `string`

A fájltartalom verziója. Lehet `null`.

**size\_bytes** `integer`

Fájlméret bájtban. Lehet `null`.

**lab\_code** `string`

Feltöltött dokumentumnál mindig `null`.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Egy űrlapmező érvénytelen, vagy a törzs nem `multipart/form-data`. |
| `403` | Az API-kulcsodból hiányzik egy scope, a profil a hozzáférési kontextusodon kívül esik, vagy `extract_results: true` értéket küldtél `documents_extract_results` nélkül. |
| `404` | A profil nem található. |
| `409` | `duplicate_document`: ugyanez a fájl már szerepel ezen a profilon. A `document_id` tartalmazza, vagy `null`, ha nem olvashatod. `Idempotency-Key` ütközés esetén is ez érkezik. |
| `413` | `file_too_large`: a fájl meghaladja a 4 MB-ot. |
| `415` | `unsupported_media_type`: a fájl nem PDF, DOC, DOCX, PNG vagy JPEG. A fájlnévnek `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` vagy `.jpeg` végződésűnek kell lennie. |
| `500` | Belső szerverhiba. `extraction_not_started`: a fájl `document_id` azonosítóval tárolva van, de a kiolvasás nem tudott elindulni. Lépj kapcsolatba az Anivával. |

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