Belgeler
Belgeyi indir
Dosya ID’si ile bir laboratuvar raporu belgesini indir
GET
/
api
/
v1
/
documents
/
{id}
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
(Binary file content — save the response to a file)
{
"error": "Document not found"
}
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 yanıtındaki documents dizisinden alınır.
results_view kapsamını gerektirir.
Erişim, belgenin sahibi olan profile göre doğrulanır. Belge yükle ile yüklediğin bir belge, yüklendiği profil grubuna göre doğrulanır.
İstek
Yol parametreleri
Yanıt
Başarılı olduğunda API, dosya baytları ve dört başlıkla birlikte200 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ı. |
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
(Binary file content — save the response to a file)
{
"error": "Document not found"
}
⌘I
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
(Binary file content — save the response to a file)
{
"error": "Document not found"
}