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

# Luo profiili

> Vaiheittainen opas: luo ja päivitä potilasprofiileja Aniva Partner API:ssa ennen kuin varaat verikokeen.

Tämän oppaan avulla luot potilasprofiilin ja liität sen profiiliryhmääsi. Profiilit ovat lähtökohta ajanvarausten tekemiselle ja laboratoriotilausten käynnistämiselle.

**1. Hanki profiiliryhmäsi tunniste**

Jokainen profiili on liitettävä kumppanitilillesi kuuluvaan profiiliryhmään. `profile_group`-kenttä hyväksyy joko ryhmän muuttumattoman UUID:n tai luettavan slugin — UUID on suositeltavampi, koska se ei koskaan muutu ja säilyy myös slugin uudelleennimeämisen jälkeen.

Jos et tiedä profiiliryhmäsi tunnistetta, ota yhteyttä Anivaan sen saamiseksi. Et voi luoda profiileja ilman kelvollista tunnistetta.

**2. Luo profiili**

Lähetä `POST`-pyyntö osoitteeseen `/api/v1/profiles` potilaan henkilötiedoilla.

> [!NOTE]
>
> Sekä `first_name` että `last_name` ovat pakollisia. Ne hyväksyvät vain latinalaisen kirjaimiston kirjaimia (mukaan lukien tarkkeelliset kirjaimet, kuten ü), välilyöntejä, yhdysmerkkejä ja heittomerkkejä. Translitteroi muilla kirjaimistoilla kirjoitetut nimet ennen niiden lähettämistä.

> [!NOTE]
>
> Jos jätät `email`-kentän pois, Aniva luo profiilille automaattisesti väliaikaisen sähköpostiosoitteen. Voit päivittää sen myöhemmin `PATCH`-pyynnöllä.

> [!TIP]
>
> `language`-kenttä määrittää kielen, jota Aniva käyttää viestiessään potilaan kanssa – esimerkiksi ajanvarausmuistutuksissa ja tulosilmoituksissa. Aseta se vastaamaan potilaan ensisijaista kieltä. Sivulla [Luo profiili](https://docs.anivahealth.com/fi/api/profiles/create-profile.md) luetellaan tuetut arvot. Oletusarvo on `en`.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "first_name": "Emma",
    "last_name": "Müller",
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "profile_group": "my-clinic-group",
    "email": "emma.muller@example.com",
    "language": "de"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/profiles', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    first_name: 'Emma',
    last_name: 'Müller',
    sex: 2,
    date_of_birth: '1990-04-15',
    profile_group: 'my-clinic-group',
    email: 'emma.muller@example.com',
    language: 'de',
  }),
});

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

Onnistunut pyyntö palauttaa tilakoodin `201 Created` ja uuden profiiliobjektin:

```json theme={null}
{
  "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
}
```

Tallenna `id` — tarvitset sitä ajanvarausten tekemiseen ja profiilin päivittämiseen.

**3. Päivitä profiili (valinnainen)**

Käytä pyyntöä `PATCH /api/v1/profiles/{id}` päivittääksesi profiilin kenttiä luomisen jälkeen. Kaikki kentät ovat valinnaisia — sisällytä vain kentät, joita haluat muuttaa.

Seuraava esimerkki lisää puhelinnumeron ja pituuden:

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "phone": "+4915123456789",
    "height": 168.5
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      phone: '+4915123456789',
      height: 168.5,
    }),
  }
);

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

Onnistunut pyyntö palauttaa tilakoodin `200 OK` ja koko päivitetyn profiiliobjektin.

## Virheenkäsittely

| Tila | Syy | Ratkaisu |
| - | - | - |
| `400 Bad Request` | Pakollinen kenttä puuttuu, arvo on sallitun alueen ulkopuolella tai `date_of_birth` on epäuskottava (tulevaisuudessa, ennen vuotta 1900 tai vastaa 16–100 ikävuoden ulkopuolista ikää). | Tarkista virhevastauksen rungosta tarkka validointiviesti ja korjaa pyyntö. |
| `403 Forbidden` | API-avaimellasi ei ole oikeutta tähän toimintoon tai sinulla ei ole käyttöoikeutta määritettyyn profiiliryhmään. | Ota yhteyttä Anivaan API-avaimesi käyttöoikeuksien ja profiiliryhmän käyttöoikeuden vahvistamiseksi. |
| `404 Not Found` | `profile_group`-arvo ei vastaa yhtään tilisi profiiliryhmää (ei UUID:llä eikä slugilla). | Tarkista, että tunniste on oikein. Ota yhteyttä Anivaan, jos et ole varma UUID:stäsi tai slugistasi. |
| `409 Conflict` | Tällä `email`-osoitteella on jo olemassa profiili (`error_name: "email_exists_error"`) tai `Idempotency-Key`-avainta käytettiin uudelleen eri rungolla. | Käytä kyseisen sähköpostiosoitteen olemassa olevaa profiilia tai lähetä uusi `Idempotency-Key`. |


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