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

# Ātrais sākums

> Veic savu pirmo Aniva partneru API izsaukumu dažu minūšu laikā: atrodi analīžu vietu, izveido profilu un piesaki asins paņemšanu.

Šī pamācība tevi iepazīstinās ar pamata darba plūsmu: testēšanas vietas atrašanu, pacienta profila izveidi, pieraksta plānošanu un asins paņemšanas apstiprināšanu.

## Priekšnosacījumi

Tev ir nepieciešama Aniva izsniegta partnera API atslēga.

> [!NOTE]
>
> Ja tev vēl nav API atslēgas, sazinies ar Aniva, lai tā tiktu izsniegta tavam partnera kontam.

## Soļi

**1. Izgūt pieejamās testēšanas vietas**

Izgūsti testēšanas vietu sarakstu, lai atrastu `location_id` pierakstam, ko plāno izveidot.

```bash theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

**Atbildes piemērs**

```json theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

Piefiksē tās testēšanas vietas `id`, kuru vēlies izmantot. Tas tev būs nepieciešams 3. solī.

**2. Izveidot profilu**

Izveido pacienta profilu, nosūtot tā demogrāfiskos datus. Lauks `profile_group` piesaista profilu tavam partnera kontam — tas pieņem vai nu grupas nemainīgo UUID, vai cilvēkam lasāmo slug identifikatoru.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/profiles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Rivera",
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "profile_group": "your-profile-group"
  }'
```

**Pieprasījuma satura lauki**

| Lauks | Tips | Obligāts | Apraksts |
| - | - | - | - |
| `first_name` | string | Jā | Pacienta vārds |
| `last_name` | string | Jā | Pacienta uzvārds |
| `sex` | integer | Jā\*\* | `1` = vīrietis, `2` = sieviete (ISO/IEC 5218) |
| `date_of_birth` | string | Jā\*\* | Dzimšanas datums formātā `YYYY-MM-DD`. Tam jābūt pagātnē, ne agrāk par 1900. gadu, un jāatbilst vecumam no 16 līdz 100 gadiem. |
| `profile_group` | string | Jā\* | Tavas partnera profilu grupas UUID vai slug identifikators. UUID ir stabila atsauce; tiek pieņemts arī slug. |
| `profile_group_slug` | string | Nē | **Novecojis.** Slug aizstājējs laukam `profile_group`. Obligāts ir vai nu `profile_group`, vai `profile_group_slug`. |
| `email` | string | Nē | Pacienta e-pasts. Ja nav norādīts, tiek ģenerēts automātiski. |
| `language` | string | Nē | `en`, `de` vai `fi`. Pēc noklusējuma `en`. |
| `phone` | string | Nē | Tālruņa numurs E.164 formātā, piemēram, `+4915123456789`. |
| `height` | number | Nē | Augums centimetros. |
| `weight` | number | Nē | Svars kilogramos. |
| `transactional_emails_enabled` | boolean | Nē | Pārraksta profilu grupas noklusējuma iestatījumu pakalpojuma e-pastiem. |
| `marketing_emails_enabled` | boolean | Nē | Pārraksta profilu grupas noklusējuma iestatījumu mārketinga e-pastiem. |

\*\* Neobligāts, ja tava profilu grupa ļauj pacientam abus datus ievadīt komplekta aktivizēšanas lapā. Skati
[Profili](https://docs.anivahealth.com/lv/concepts/profiles.md#laut-pacientam-ievadit-dzimsanas-datumu-un-dzimumu).

**Atbildes piemērs (201 Created)**

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "handle": null,
  "first_name": "Jordan",
  "last_name": "Rivera",
  "email": "jordan.rivera@example.com",
  "phone": null,
  "sex": 1,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "en",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null
}
```

Piefiksē atbildē saņemto `id`. Nākamajā solī tu to izmantosi kā `profile_id`.

**3. Ieplānot pierakstu**

Izveido pierakstu, izmantojot `profile_id` no 2. soļa un `location_id` no 1. soļa. Iestati `scheduled_at` uz brīvā laika sākumu, ko šai testēšanas vietai atgriež [Izgūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md). API noraida laiku, kas neatbilst pieejamo laiku grafikam.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "scheduled_at": "2026-04-10T09:00:00Z"
  }'
```

**Atbildes piemērs (201 Created)**

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "scheduled_at": "2026-04-10T09:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T10:05:00Z",
  "updated_at": null,
  "profile": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "handle": null,
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": null,
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "en",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T10:00:00Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Piefiksē pieraksta `id`. Tu to izmantosi, lai apstiprinātu asins paņemšanu.

**4. Apstiprināt asins paņemšanu**

Kad asins paņemšana ir pabeigta, iesniedz laboratorijas kodu (stobriņa svītrkodu), lai apstiprinātu asins paņemšanu un uzsāktu laboratorijas pasūtījumu plūsmu. Ja stobriņiem ir vairāki kodi, tā vietā sūti `lab_codes` — skati [Apstiprināt asins paņemšanu](https://docs.anivahealth.com/lv/api/appointments/confirm-blood-draw.md).

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments/c3d4e5f6-a7b8-9012-cdef-123456789012/confirm \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lab_code": "7642001234"
  }'
```

**Atbildes piemērs (200 OK)**

```json theme={null}
{
  "success": true
}
```

Pēc apstiprināšanas tiek uzsākta laboratorijas pasūtījumu plūsma. Tu vari izgūt pierakstu, lai pārliecinātos, ka tā statuss ir mainījies uz `"blood_drawn"`.

## Nākamie soļi

* [Pievieno paneļus pierakstam](https://docs.anivahealth.com/lv/api/appointments/add-panels.md), lai norādītu, kuras laboratorijas analīzes veikt.
* [Atjaunini pierakstu](https://docs.anivahealth.com/lv/api/appointments/update-appointment.md), lai pārceltu laiku vai mainītu vietu pirms asins paņemšanas.
* [Atcel pierakstu](https://docs.anivahealth.com/lv/api/appointments/cancel-appointment.md), ja tas vairs nav vajadzīgs.
* [Iegūsti laboratorijas rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md), lai saņemtu klīniskos un ģenētiskos rezultātus pēc apstrādes.
* [Lejupielādē dokumentus](https://docs.anivahealth.com/lv/api/documents/download-document.md), lai iegūtu laboratorijas pārskatu PDF failus.
* [Iegūsti profilu](https://docs.anivahealth.com/lv/api/profiles/get-profile.md), lai pārbaudītu vai parādītu pacienta datus.
* Apskati pilnu [API atsauci](https://docs.anivahealth.com/lv/api/profiles/create-profile.md), lai redzētu visus pieejamos galapunktus un parametrus.


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