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

# Izveidot iegulšanas sesiju

> Iegūt vienreizēju URL, kas rāda profila laboratorijas rezultātus tavā lietotnē

Iegūsti URL, kas rāda viena profila laboratorijas rezultātus kā tikai lasāmu lapu. Atver URL savas lietotnes WebView skatā vai pārlūka cilnē. Izsauc šo galapunktu no sava servera katru reizi, kad lietotājs atver rezultātus, un nekad neglabā URL kešatmiņā.

Nepieciešamas `embed` un `results_view` piekļuves jomas profila grupā, kurai pieder profils. Aniva piešķir `embed` piekļuves jomu pēc pieprasījuma. Ja trūkst kādas no šīm divām piekļuves jomām, pieprasījums atgriež `403`.

> [!NOTE]
>
> URL darbojas vienu reizi un 5 minūtes. Kad to atver, lapa sāk 60 minūšu sesiju, kas
> darbojas tikai šajā lapā. Arhivē savu API atslēgu, lai uzreiz aizvērtu visas atvērtās lapas.

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Tā profila unikālais identifikators (UUID), kura rezultātus lapa rāda.

### Pieprasījuma pamatteksts

Pieprasījuma pamatteksts nav obligāts. Bez tā URL atver biomarķieru sarakstu profila valodā.

**language** `string`

Lapas valoda: `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` vai `uk`. Noklusējums: profila valoda.

**route** `object`

Lapa, ko atver URL. Noklusējums: `{ "name": "biomarkers" }`. Jebkura cita `name` vērtība atgriež `400`.

**publicētās lapas**

**name** `string` *required*

Viena no:

* `biomarkers`: visu biomarķieru saraksts ar to jaunākajiem rezultātiem.
* `biomarker`: viena biomarķiera detalizētā lapa ar tā tendenci, intervāliem un skaidrojumu. Nepieciešams `biomarker_id`.
* `twin`: 3D ķermenis ar novērtējumu katrai veselības jomai. Lietotājs izvēlas jomu, lai redzētu tās biomarķierus.

**biomarker\_id** `integer`

Tikai `biomarker` lapai. Biomarķiera `biomarker_id`, kāds tas ir rezultātos, piemēram, `104`. Izmanto ID, nevis slug: slug var mainīties, bet ID nemainās.

**report** `object`

Ierobežo katru lapu ar vienu profila laboratorijas pārskatu. Noklusējums: visi profila pārskati. Nosūti
tieši vienu no trim ID. Saraksts, biomarķiera tendence un Twin tad rāda tikai šī pārskata
rezultātus, un lapa paslēpj pierakstu filtru. Ar šo URL lietotājs nevar atvērt
citu pārskatu.

**īpašības**

**appointment\_id** `string`

Profila pieraksta `id`. Tavai atslēgai ir jābūt piekļuvei tam, tāpat kā
[Iegūt laboratorijas rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md). Ja piekļuves nav, šis galapunkts atgriež
`404`, nevis `403`.

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

Profila mājas testa komplekta pasūtījuma `id`. Tavai atslēgai ir jābūt piekļuvei tam, tāpat kā
[Iegūt laboratorijas rezultātus](https://docs.anivahealth.com/lv/api/home-kit-orders/get-results.md) mājas testa komplektu pasūtījumiem, un ir nepieciešams arī
`home_kit_orders_view` vai `home_kit_orders_manage`.

**document\_id** `string`

Profila laboratorijas pārskata `id`, ko augšupielādēji ar
[Augšupielādēt dokumentu](https://docs.anivahealth.com/lv/api/documents/upload-document.md). Tavai atslēgai ir jābūt piekļuvei tam, tāpat kā
[Iegūt dokumenta rezultātus](https://docs.anivahealth.com/lv/api/documents/get-document-results.md). Ja piekļuves nav, šis galapunkts
atgriež `404`, nevis `403`. Lapa rāda laboratorijas analīžu datumu vai augšupielādes datumu, ja
vēl nav nolasīta neviena vērtība. Kamēr Aniva nolasa dokumentu un vērtību vēl nav, katra lapa aicina
lietotāju atvērt to vēlreiz pēc dažām minūtēm.

**appearance** `object`

Lapas izskats. API pievieno to URL kā vaicājuma parametrus.

**īpašības**

**theme** `string`

`light` vai `dark`. Noklusējums: ierīces sistēmas iestatījums.

**primary\_color** `string`

Pogu un saišu heksadecimālā krāsa, 3 vai 6 simboli, ar vai bez `#`, piemēram, `0f766e`.
Noklusējums: tavas profilu grupas zīmola krāsa, citādi Aniva oranžā. Pogām saglabājas balts teksts,
tāpēc izvēlies tumšu krāsu.

**show\_logo** `boolean`

Rādīt tavas profilu grupas logotipu virs rezultātiem. Noklusējums: `true`.

> [!TIP]
>
> Izskata parametrus vari pievienot atgrieztajam URL arī patstāvīgi pirms `#token=`
> fragmenta: `theme=light|dark`, `primary=<hex>` un `logo=0`. Nederīgu vērtību lapa ignorē.
> Logotipa attēls vienmēr tiek ņemts no tavas profilu grupas, nekad no URL.

## Atbilde

Ja pieprasījums ir veiksmīgs, API atgriež `201 Created`.

**url** `string` *required*

Lapas URL. Palaišanas marķieris ir `#token=` fragmentā, tāpēc pārlūkprogramma to nekad nesūta
serverim. Atver to vienu reizi.

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

ISO 8601 laika zīmogs, pēc kura URL vairs nevar atvērt.

Sesija nav piesaistīta vienai lapai. Iegultajā skatā lietotājs var pāriet no Twin uz biomarķieri, kā arī starp sarakstu un detalizētajām lapām. Lapa rāda tikai laboratorijas rezultātus: tā nerāda Aniva aprēķinātās vērtības, failus, čatu vai iestatījumus.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — nederīgs profila ID, nezināms `route.name`, nederīgs `biomarker_id`, nederīga krāsa vai `report` bez tieši viena derīga UUID. |
| `403` | Aizliegts — tavai API atslēgai trūkst `embed` vai `results_view` tvēruma, vai mājas testa komplekta tvēruma mājas testa komplekta pasūtījuma pārskatam, vai profils ir ārpus tava piekļuves konteksta. |
| `404` | Profils nav atrasts, vai nevienam biomarķierim nav šāda `biomarker_id`, vai `report` nav šī profila pieraksts, mājas testa komplekta pasūtījums vai augšupielādēts dokuments, vai pārskats ir ārpus tavas piekļuves. Šis galapunkts atgriež `404`, nevis `403`, lai neatklātu, ka pārskats eksistē. |
| `500` | Iekšēja servera kļūda. |

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