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

# Belge yükle

> Bir profile laboratuvar raporu veya başka bir belge yükle ve isteğe bağlı olarak laboratuvar değerlerini çıkar

Bir profile tek bir dosya yükle. `multipart/form-data` olarak gönder. `extract_results` olmadan Aniva yalnızca
dosyayı saklar. `extract_results: true` ile Aniva dosyadaki laboratuvar değerlerini de okur.

Dosyanın ne tür bir rapor olduğunu belirtmezsin. Aniva karar verir. Doktor yazısı gibi laboratuvar sonuçları
içermeyen bir dosya `stored` olarak sonlanır ve bu bir hata değildir.

Değerleri [Belge sonuçlarını al](https://docs.anivahealth.com/tr/api/documents/get-document-results.md) ile oku. Sürekli sorgulama yapmana
gerek yok: `document.results.*` [webhook](https://docs.anivahealth.com/tr/concepts/webhooks.md) bildirimlerine abone ol.

Profilin bir profil grubunda `documents_upload` kapsamını gerektirir. `extract_results: true`
ayrıca aynı grupta `documents_extract_results` kapsamını gerektirir. Bunları eklemesini Aniva'dan iste.
Belge o gruba aittir: o grupta `results_view` kapsamına sahip anahtarlar belgeyi ve sonuçlarını okur.

Yüklemeyi güvenle yeniden deneyebilmek için isteğe bağlı bir `Idempotency-Key` başlığı gönder. Bkz.
[Idempotency](https://docs.anivahealth.com/tr/concepts/idempotency.md).

## Çıkarma işlemi ne yapar

`extract_results: true` ile:

1. Aniva, değerleri okumak için dosyayı OCR ve yapay zeka alt işleyicilerine gönderir.
2. Değerler, diğer tüm sonuçlar gibi üyenin Aniva uygulamasında görünür.
3. Her değer `origin: partner_upload` ve diğer tüm sonuçlarla aynı `status` alanını taşır. Aniva'nın
   otomatik kontrolünün şüphelendiği bir değerin durumu `likely_wrong` olur.

Bu olmadan, `document_date` alanını da gönderdiğinde dosya hiçbir dış hizmete gitmez.

> [accordion] Doğruluk ve veri koruma
>
> * Otomatik okuma bir değeri, birimi veya tarihi yanlış okuyabilir. Orijinal dosya asıl kaynak
>   olarak kalır. Bir değeri tıbbi bir karar için kullanmadan önce orijinal dosyayla kontrol et.
>   Çıkarılan değerler tanı değildir.
> * Alt işleyiciler Mistral AI (OCR, AB) ve Vercel AI Gateway üzerinden erişilen Google Cloud Vertex
>   AI'dır (veri çıkarma, AB dışında işleyebilir). Dosyayı yalnızca okumak için işlerler.
> * Bir üyenin sağlık verilerini yüklemek için yasal bir dayanağa, normalde üyenin açık rızasına
>   ihtiyacın vardır. Bundan sen sorumlusun.

## İstek

### Form alanları

**file** `file` *required*

Dosya. PDF, DOC, DOCX, PNG veya JPEG, en fazla 4 MB.

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

Belgenin ait olduğu profilin UUID'si.

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

Dosyadaki laboratuvar değerlerini okumak için `true`. `true` veya `false` gönder.

**document\_date** `string`

Biliyorsan `YYYY-MM-DD` biçiminde numune tarihi. Bu alan olmadan Aniva tarihi dosyadan okur.

## Yanıt

API, dosyayı yalnızca sakladığında `201 Created`, veri çıkarma çalıştığında ise `202 Accepted` döndürür.

**id** `string` *required*

Belge kimliği (UUID). [Belge sonuçlarını al](https://docs.anivahealth.com/tr/api/documents/get-document-results.md) ve
[Belgeyi indir](https://docs.anivahealth.com/tr/api/documents/download-document.md) ile kullan.

**status** `string` *required*

Aniva değerleri çıkarırken `processing` veya dosya yalnızca saklandığında `stored`.

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

Belgenin ait olduğu profil.

**document\_date** `string`

Gönderdiğin numune tarihi veya Aniva'nın saklanan bir dosyadan okuduğu tarih. `null` olabilir.

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

Bu belgenin [Belge sonuçlarını al](https://docs.anivahealth.com/tr/api/documents/get-document-results.md) URL'si.

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

Görüntüleme için dosya adı, [Belgeyi indir](https://docs.anivahealth.com/tr/api/documents/download-document.md) ile gönderilenle aynı.

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

Yüklediğin dosya adı.

**origin** `string` *required*

Her zaman `partner_upload`.

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

Dosyanın medya türü, örn. `application/pdf`.

**etag** `string`

Dosya içeriğinin sürümü. `null` olabilir.

**size\_bytes** `integer`

Bayt cinsinden dosya boyutu. `null` olabilir.

**lab\_code** `string`

Yüklenen bir belge için her zaman `null`.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Bir form alanı geçersiz veya gövde `multipart/form-data` değil. |
| `403` | API anahtarında bir kapsam eksik, profil erişim bağlamının dışında veya `documents_extract_results` olmadan `extract_results: true` gönderdin. |
| `404` | Profil bulunamadı. |
| `409` | `duplicate_document`: Aynı dosya bu profilde zaten var. `document_id` bunu belirtir veya okuyamıyorsan `null` olur. Bir `Idempotency-Key` çakışmasında da gönderilir. |
| `413` | `file_too_large`: Dosya 4 MB sınırını aşıyor. |
| `415` | `unsupported_media_type`: Dosya PDF, DOC, DOCX, PNG veya JPEG değil. Dosya adı `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` veya `.jpeg` ile bitmelidir. |
| `500` | Sunucu iç hatası. `extraction_not_started`: Dosya `document_id` olarak saklandı ancak veri çıkarma başlatılamadı. Aniva ile iletişime geç. |

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