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

# Gömülü oturum oluştur

> Bir profilin laboratuvar sonuçlarını uygulamanın içinde gösteren tek kullanımlık bir URL al

Bir profilin laboratuvar sonuçlarını salt okunur bir sayfa olarak gösteren bir URL al. URL'yi uygulamanda bir WebView içinde veya bir tarayıcı sekmesinde aç. Kullanıcı sonuçları her açtığında bu uç noktayı sunucundan çağır ve URL'yi asla önbelleğe alma.

Profilin bir profil grubunda `embed` ve `results_view` kapsamlarını gerektirir. Aniva, `embed` kapsamını talep üzerine verir. İki kapsamdan biri eksikse istek `403` döndürür.

> [!NOTE]
>
> URL bir kez ve 5 dakika boyunca çalışır. Açıldığında sayfa, yalnızca o sayfaya ait 60 dakikalık
> bir oturum başlatır. Açık tüm sayfaları tek seferde kapatmak için API anahtarını arşivle.

## İstek

### Yol parametreleri

**id** `string` *required*

Sayfada sonuçları gösterilen profilin benzersiz kimliği (UUID).

### Gövde

Gövde isteğe bağlıdır. Gövde olmadan URL, biyobelirteç listesini profilin dilinde açar.

**language** `string`

Sayfa dili: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` veya `uk`. Varsayılan: profilin dili.

**route** `object`

URL'nin açtığı sayfa. Varsayılan: `{ "name": "biomarkers" }`. Başka herhangi bir `name` değeri `400` döndürür.

**yayınlanan sayfalar**

**name** `string` *required*

Şunlardan biri:

* `biomarkers`: en güncel sonuçlarıyla tüm biyobelirteçlerin listesi.
* `biomarker`: eğilimi, aralıkları ve açıklamasıyla birlikte tek bir biyobelirtecin detay sayfası. `biomarker_id` gerektirir.
* `twin`: her sağlık alanı için bir puan gösteren 3D vücut. Kullanıcı biyobelirteçlerini görmek için bir alan seçer.

**biomarker\_id** `integer`

Yalnızca `biomarker` için. Sonuçlarda yer alan şekliyle biyobelirtecin `biomarker_id` değeri, örneğin `104`. Slug yerine ID'yi kullan: slug değişebilir, ID sabit kalır.

**report** `object`

Her sayfayı profilin tek bir laboratuvar raporuyla sınırlar. Varsayılan: profilin tüm raporları.
Üç ID'den tam olarak birini gönder. Bu durumda liste, bir biyobelirtecin eğilimi ve Twin
yalnızca o raporun sonuçlarını gösterir ve sayfa randevu filtresini gizler. Kullanıcı bu URL ile
başka bir rapor açamaz.

**özellikler**

**appointment\_id** `string`

Profilin bir randevusunun `id` değeri. [Laboratuvar sonuçlarını al](https://docs.anivahealth.com/tr/api/appointments/get-results.md)
için olduğu gibi anahtarının buna erişimi olmalıdır. Erişimi yoksa bu uç nokta `403` değil
`404` döndürür.

**home\_kit\_order\_id** `string`

Profilin bir evde test kiti siparişinin `id` değeri. Evde test kiti siparişleri için
[Laboratuvar sonuçlarını al](https://docs.anivahealth.com/tr/api/home-kit-orders/get-results.md) ile aynı şekilde anahtarının
buna erişimi olmalı ve `home_kit_orders_view` veya `home_kit_orders_manage` kapsamına sahip
olmalıdır.

**document\_id** `string`

[Belge yükle](https://docs.anivahealth.com/tr/api/documents/upload-document.md) ile profil için yüklediğin bir laboratuvar
raporunun `id` değeri. [Belge sonuçlarını al](https://docs.anivahealth.com/tr/api/documents/get-document-results.md) için
olduğu gibi anahtarının buna erişimi olmalıdır. Erişimi yoksa bu uç nokta `403` değil `404`
döndürür. Sayfa, laboratuvar testinin tarihini ya da henüz bir değer okunmadıysa yükleme
tarihini gösterir. Aniva belgeyi okurken ve henüz bir değer yokken her sayfa kullanıcıya
birkaç dakika sonra tekrar açmasını söyler.

**appearance** `object`

Sayfanın görünümü. API bunu URL'ye arama parametreleri olarak ekler.

**özellikler**

**theme** `string`

`light` veya `dark`. Varsayılan: cihazın sistem ayarı.

**primary\_color** `string`

Düğmelerin ve bağlantıların hex rengi, 3 veya 6 haneli, `#` işaretli veya işaretsiz, örneğin `0f766e`.
Varsayılan: profil grubunun marka rengi, yoksa Aniva turuncusu. Düğmelerde metin beyaz kalır,
bu yüzden koyu bir renk seç.

**show\_logo** `boolean`

Sonuçların üzerinde profil grubunun logosunu göster. Varsayılan: `true`.

> [!TIP]
>
> Görünüm parametrelerini döndürülen bir URL'ye `#token=` bölümünden önce kendin de
> ekleyebilirsin: `theme=light|dark`, `primary=<hex>` ve `logo=0`. Sayfa geçersiz değerleri yok
> sayar. Logo görseli her zaman profil grubundan gelir, asla URL'den alınmaz.

## Yanıt

Başarılı olduğunda API `201 Created` döndürür.

**url** `string` *required*

Sayfa URL'si. Başlatma belirteci `#token=` bölümündedir, bu nedenle tarayıcı bunu asla bir
sunucuya göndermez. Bir kez aç.

**expires\_at** `string` *required*

Sonrasında URL'nin açılamayacağı ISO 8601 zamanı.

Oturum tek bir sayfaya bağlı değildir. Gömülü görünüm içinde kullanıcı Twin'den bir biyobelirtece ve liste ile detay sayfaları arasında geçiş yapabilir. Sayfa yalnızca laboratuvar sonuçlarını gösterir: Aniva'nın hesapladığı değerleri, dosyaları, sohbeti veya ayarları göstermez.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — geçersiz profil ID'si, bilinmeyen `route.name`, geçersiz `biomarker_id`, geçersiz renk veya tam olarak bir geçerli UUID içermeyen `report`. |
| `403` | Yasaklandı — API anahtarında `embed` veya `results_view` kapsamı ya da bir evde test kiti siparişi raporu için evde test kiti kapsamı eksik veya profil erişim bağlamının dışında. |
| `404` | Profil bulunamadı, bu `biomarker_id` değerine sahip biyobelirteç yok, `report` bu profile ait bir randevu, evde test kiti siparişi veya yüklenmiş belge değil ya da rapor erişiminin dışında. Bu uç nokta, raporun var olduğunu göstermemek için `403` değil `404` döndürür. |
| `500` | İç sunucu hatası. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d/embed-sessions \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "language": "de",
    "route": { "name": "biomarker", "biomarker_id": 104 },
    "report": { "appointment_id": "8d2e4f6a-1b3c-4d5e-9f70-a1b2c3d4e5f6" },
    "appearance": { "theme": "light", "primary_color": "0f766e" }
  }'
```

```bash One uploaded document theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles/{id}/embed-sessions \
  --header 'Authorization: Bearer <api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "report": { "document_id": "3f9a7c2e-5d4b-4e1a-8c6f-0b1d2e3f4a5b" }
  }'
```

```json 201 theme={null}
{
  "url": "https://anivahealth.com/de/embed/biomarkers/vitamin-d?theme=light&primary=0f766e#token=eyJwdXJwb3NlIjoiZW1iZWRfbGF1bmNoIi4uLn0.k7Qm2V0sZ1yH",
  "expires_at": "2026-11-19T20:17:43.000Z"
}
```

```json 400 theme={null}
{
  "error": "route.name: Invalid discriminator value. Expected 'biomarkers' | 'biomarker' | 'twin'"
}
```

```json 403 theme={null}
{
  "error": "Access denied: profile is outside your permission scope"
}
```

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

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


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