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

# Ieplānot pierakstu

> Ceļvedis soli pa solim: atrodi analīžu vietu, pārbaudi pieejamību un rezervē asins paņemšanas pierakstu ar Aniva API.

Izmanto šo ceļvedi, lai atrastu testēšanas vietu, izveidotu pierakstu pacienta profilam un pievienotu veicamos testu paneļus. Izpildi šīs darbības pirms pacienta ierašanās uz asins paņemšanu.

**1. Pārlūkot pieejamās vietas**

Iegūsti savā kontā pieejamo testēšanas vietu sarakstu, nosūtot `GET` pieprasījumu uz `/api/v1/locations`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/locations', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

const locations = await response.json();
```

Atbilde ir vietu objektu masīvs:

```json theme={null}
[
  {
    "id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Friedrichstraße",
    "house_number": "112",
    "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": "17:00" }],
      "tuesday": [{ "open": "08:00", "close": "17:00" }],
      "wednesday": [{ "open": "08:00", "close": "17:00" }],
      "thursday": [{ "open": "08:00", "close": "17:00" }],
      "friday": [{ "open": "08:00", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

> [!TIP]
>
> Veidojot `scheduled_at` laikspiedolu, izmanto vietas objekta lauku `timezone`. Pieraksta laika pārvēršana vietas vietējā laika joslā palīdz izvairīties no pieraksta plānošanas ārpus darba laika.

> [!WARNING]
>
> Nenosaki pieejamos pieraksta laikus tikai pēc `open_hours`. Izsauc [Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md) un rezervē tā atgriezto laika posma sākumu — šajā grafikā ir ņemti vērā arī esošie pieraksti, atsevišķu datumu izņēmumi un minimālais pieteikšanas laiks.

**2. Izveidot pierakstu**

Nosūti `POST` pieprasījumu uz `/api/v1/appointments` ar profila ID, vietas ID un vēlamo pieraksta laiku. Laikam jābūt laika posma sākumam no [Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md).

> [!NOTE]
>
> `scheduled_at` jābūt nākotnes datumam un laikam ISO 8601 formātā, piemēram, `2026-05-12T07:30:00Z`. Laikspiedoli pagātnē tiek noraidīti ar `400` kļūdu, tāpat kā laiki, kas iekrīt [12 stundu minimālajā pieteikšanas laikā](https://docs.anivahealth.com/lv/api/appointments/create-appointment.md#minimalais-pieteiksanas-laiks) Aniva pārvaldītajās vietās.

> [!TIP]
>
> Šo pieprasījumu var droši atkārtot. Profilam katrā vietā un laikā var būt tikai viens pieraksts, tāpēc atkārtoti vai divreiz nosūtīts izveides pieprasījums atgriež `409` ar esošo `appointment_id`, nevis pieraksta pacientu divreiz.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "scheduled_at": "2026-05-12T07:30:00Z"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/appointments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    profile_id: 'a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
    location_id: 'b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421',
    scheduled_at: '2026-05-12T07:30:00Z',
  }),
});

const appointment = await response.json();
```

Veiksmīgs pieprasījums atgriež `201 Created` ar pieraksta objektu:

```json theme={null}
{
  "id": "c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12",
  "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
  "scheduled_at": "2026-05-12T07:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T11:02:47Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "handle": null,
    "first_name": "Emma",
    "last_name": "Müller",
    "email": "emma.muller@example.com",
    "phone": null,
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "de",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T09:14:22Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Saglabā pieraksta `id` — tas būs nepieciešams paneļu pievienošanai un asins paņemšanas apstiprināšanai.

**3. Pievienot testu paneļus**

Pievieno testu paneļus, kurus vēlies veikt asins paraugam, nosūtot `POST` pieprasījumu uz `/api/v1/appointments/{id}/panels`.

Paneļu ID ir UUID. Izsauc [Iegūt paneļu sarakstu](https://docs.anivahealth.com/lv/api/panels/list-panels.md), lai iegūtu paneļus, kurus tava API atslēga var pasūtīt.

> [!WARNING]
>
> Pēc asins paņemšanas apstiprināšanas paneļus pievienot vairs nevar. Pievieno visus nepieciešamos paneļus pirms apstiprināšanas — sīkāku informāciju skati sadaļā [Apstiprināt asins paņemšanu](https://docs.anivahealth.com/lv/guides/confirm-blood-draw.md).

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "panel_ids": [
      "d1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27",
      "e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38"
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      panel_ids: [
        'd1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27',
        'e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38',
      ],
    }),
  }
);

const result = await response.json();
```

Veiksmīgs pieprasījums atgriež `200 OK`, apstiprinot, ka paneļi ir pievienoti:

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

## Pārplānošana vai atcelšana

Pēc pieraksta izveides to joprojām vari mainīt pirms asins paņemšanas apstiprināšanas:

* **Pārplānot vai mainīt vietu** — nosūti `PATCH` pieprasījumu uz `/api/v1/appointments/{id}` ar atjaunināmajiem laukiem. Skati [Atjaunināt pierakstu](https://docs.anivahealth.com/lv/api/appointments/update-appointment.md).
* **Atcelt** — nosūti `DELETE` pieprasījumu uz `/api/v1/appointments/{id}`. Skati [Atcelt pierakstu](https://docs.anivahealth.com/lv/api/appointments/cancel-appointment.md).

> [!NOTE]
>
> Abas darbības ir pieejamas tikai pirms asins paņemšanas — t. i., kamēr pierakstam ir statuss
> `pending` vai `confirmed`. Kad pieraksts pāriet statusā `blood_drawn`, nekādas turpmākas
> izmaiņas vairs nav iespējamas.

## Kļūdu apstrāde

| Statuss | Cēlonis | Risinājums |
| - | - | - |
| `400 Bad Request` | Trūkst obligātā lauka, `scheduled_at` ir pagātnē, neatbilst laika posmu grafikam vai iekrīt 12 stundu minimālajā pieteikšanas laikā, vai `panel_ids` ir tukšs. | Pārbaudi kļūdas pamattekstā norādīto validācijas ziņojumu un izlabo pieprasījumu. Minimālā pieteikšanas laika gadījumā izvēlies vēlāku laika posmu no [Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md). |
| `403 Forbidden` | Tavai API atslēgai nav piekļuves šai darbībai. | Sazinies ar Aniva, lai apstiprinātu savas API atslēgas atļaujas. |
| `404 Not Found` | `profile_id` vai `location_id` neeksistē, vai, pievienojot paneļus, pieraksta ID nav derīgs. | Pārbaudi, vai ID ir pareizi un pieder tavam kontam. |
| `409 Conflict` | Mēģināji pievienot paneļus vai mainīt pierakstu, kam jau ir statuss `blood_drawn` vai `cancelled`. | Pēc apstiprināšanas turpmākas izmaiņas vairs nav iespējamas. |
| `409 Conflict` | Šim profilam šajā vietā un laikā jau ir pieraksts, vai laika posms ir pilns. | Dublikāta gadījumā atbildē ir iekļauts esošais `appointment_id` — izmanto to pierakstu, nevis mēģini atkārtoti. Pretējā gadījumā izvēlies citu laika posmu. |


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