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

# Belgeyi indir

> Dosya ID'si ile bir laboratuvar raporu belgesini indir

Dosya kimliğine göre bir laboratuvar raporu belgesi indir. Uygun `Content-Type` başlığıyla ham dosya baytlarını döndürür. Belge kimlikleri [Laboratuvar sonuçlarını al](https://docs.anivahealth.com/tr/api/appointments/get-results.md) yanıtındaki `documents` dizisinden alınır.

`results_view` kapsamını gerektirir.

> [!NOTE]
>
> Erişim, belgenin sahibi olan profile göre doğrulanır. [Belge yükle](https://docs.anivahealth.com/tr/api/documents/upload-document.md) ile yüklediğin bir belge, yüklendiği profil grubuna göre doğrulanır.

## İstek

### Yol parametreleri

**id** `string` *required*

Randevu sonuçları yanıtındaki `documents` dizisinden alınan dosya kimliği (UUID).

## Yanıt

Başarılı olduğunda API, dosya baytları ve dört başlıkla birlikte `200 OK` döndürür. Her başlık `documents` dizisinin bir alanını taşır:

| Başlık | Alan | Örnek |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (tırnak içinde) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` yüzde kodlamalı UTF-8 biçimindedir çünkü bir başlık, yüklenen bir adın içerebileceği tüm karakterleri taşıyamaz. `decodeURIComponent` veya eşdeğeri ile çöz.

`ETag` ve `If-None-Match` standart HTTP önbellekleme başlıklarıdır (RFC 9110). Değişmemiş bir dosyayı atlamak için elindeki `etag` değerini `If-None-Match` içinde gönder. API bu durumda gövdesiz olarak `304 Not Modified` yanıtını verir.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `304` | Değiştirilmedi — `If-None-Match` etag değeri hâlâ dosyayla eşleşiyor. Gövde yok. |
| `400` | Geçersiz kimlik biçimi — verilen değer geçerli bir UUID değil. |
| `403` | Yasak — API anahtarının bu işleme erişimi yok veya belge erişim bağlamının dışında. |
| `404` | Belge bulunamadı. |
| `500` | Dahili sunucu hatası. |

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