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

# Stáhnout dokument

> Stáhnout dokument s laboratorní zprávou podle ID souboru

Stáhni dokument laboratorní zprávy podle ID souboru. Vrací surové bajty souboru s příslušnou hlavičkou `Content-Type`. ID dokumentů najdeš v poli `documents` v odpovědi [Získat laboratorní výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md).

Vyžaduje scope `results_view`.

> [!NOTE]
>
> Přístup se ověřuje podle profilu, kterému dokument patří. Dokument nahraný pomocí [Nahrát dokument](https://docs.anivahealth.com/cs/api/documents/upload-document.md) se ověřuje podle skupiny profilů, pod kterou byl nahrán.

## Požadavek

### Parametry cesty

**id** `string` *required*

ID souboru (UUID) z pole `documents` v odpovědi s výsledky termínu.

## Odpověď

Při úspěchu API vrátí `200 OK` s bajty souboru a čtyřmi hlavičkami. Každá hlavička nese jedno z polí v `documents`:

| Hlavička | Pole | Příklad |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (v uvozovkách) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` je v kódování UTF-8 s procentním kódováním, protože hlavička nemůže obsahovat všechny znaky, které může mít název nahraného souboru. Dekóduj ho pomocí `decodeURIComponent` nebo ekvivalentní funkce.

`ETag` a `If-None-Match` jsou standardní HTTP hlavičky pro cachování (RFC 9110). Pošli svůj `etag` v `If-None-Match`, ať se nezměněný soubor přeskočí. API pak odpoví `304 Not Modified` bez těla.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `304` | Nezměněno — etag v `If-None-Match` stále odpovídá souboru. Bez těla. |
| `400` | Neplatný formát ID — zadaná hodnota není platné UUID. |
| `403` | Zakázáno — tvůj API klíč nemá k této operaci přístup, nebo je dokument mimo tvůj přístupový kontext. |
| `404` | Dokument nebyl nalezen. |
| `500` | Interní chyba serveru. |

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