> ## 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 letöltése

> Laborlelet-dokumentum letöltése fájlazonosító alapján

Tölts le egy laborlelet-dokumentumot a fájlazonosítója alapján. A nyers fájlbájtokat adja vissza a megfelelő `Content-Type` fejléccel. A dokumentumazonosítókat a [Laboreredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) válasz `documents` tömbjéből kapod meg.

A `results_view` scope szükséges.

> [!NOTE]
>
> A hozzáférést a dokumentumot birtokló profil alapján ellenőrizzük. A [Dokumentum feltöltése](https://docs.anivahealth.com/hu/api/documents/upload-document.md) segítségével feltöltött dokumentumot azon profilcsoport alapján ellenőrizzük, amely alá feltöltötték.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

A fájlazonosító (UUID) az időpont eredményeinek válaszában található `documents` tömbből.

## Válasz

Sikeres kérés esetén az API `200 OK` választ ad vissza a fájlbájtokkal és négy fejléccel. Minden fejléc a `documents` tömb egy-egy mezőjét tartalmazza:

| Fejléc | Mező | Példa |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (idézőjelek között) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

Az `Original-File-Name` százalékkódolt UTF-8 formátumú, mert egy fejléc nem tartalmazhat minden karaktert, amely egy feltöltött fájlnévben előfordulhat. Dekódold a `decodeURIComponent` függvénnyel vagy annak megfelelőjével.

Az `ETag` és az `If-None-Match` szabványos HTTP gyorsítótárazási fejlécek (RFC 9110). Küldd el a nálad lévő `etag` értéket az `If-None-Match` fejlécben, hogy kihagyd a változatlan fájlokat. Az API ilyenkor `304 Not Modified` választ ad törzs nélkül.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `304` | Nem módosult – az `If-None-Match` etag értéke továbbra is megegyezik a fájllal. Nincs törzs. |
| `400` | Érvénytelen azonosítóformátum – a megadott érték nem érvényes UUID. |
| `403` | Tiltott – az API-kulcsod nem rendelkezik hozzáféréssel ehhez a művelethez, vagy a dokumentum kívül esik a hozzáférési körödön. |
| `404` | A dokumentum nem található. |
| `500` | Belső szerverhiba. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c \
  --header 'x-api-key: YOUR_API_KEY' \
  --output lab-report.pdf
```

```text 200 theme={null}
(Binary file content — save the response to a file)
```

```json 404 theme={null}
{
  "error": "Document not found"
}
```


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