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

# Webhookit

> Saat Anivalta HTTPS-kutsun, kun ajanvaraus, kotitestipakkauksen tilaus, sen tulokset, ladattu dokumentti, toimipiste, profiili tai lähetys muuttuu

Webhook on HTTPS `POST` -pyyntö, jonka Aniva lähettää palvelimellesi, kun jokin muuttuu. Sinun ei
tarvitse kysellä muutoksia toistuvasti.

Tapahtumat ovat kevyitä. Ne sisältävät kohteen tunnisteen, uuden tilan, version ja luettavan `url`-osoitteen. Ne
eivät koskaan sisällä laboratorioarvoja tai henkilötietoja. Hae tiedot lukemalla `url` API-avaimellasi.

## Pikakäyttöönotto

1. Rakenna HTTPS-päätepiste, joka ottaa vastaan `POST`-pyyntöjä ja vastaa `2xx`-koodilla 15 sekunnin kuluessa.
2. Rekisteröi se toiminnolla [Luo webhook](https://docs.anivahealth.com/fi/api/webhooks/create-webhook.md).
   Tallenna vastauksen `secret`. Aniva näyttää sen vain kerran.
3. [Tarkista allekirjoitus](#vahvista-allekirjoitus) jokaisesta pyynnöstä.
4. Lähetä [testitapahtuma](https://docs.anivahealth.com/fi/api/webhooks/send-test-event.md). Tarkista tulos kohdasta
   [Listaa toimitukset](https://docs.anivahealth.com/fi/api/webhooks/list-deliveries.md).

API-avaimesi tarvitsee `webhooks_manage`-käyttöoikeuden. Pyydä Anivaa lisäämään se. Webhook kuuluu sen
luoneelle API-avaimelle, ja yhdellä avaimella voi olla enintään 5 webhookia.

## Tapahtumat

Saat tapahtuman vain objekteista, joita API-avaimesi voi lukea vastaavalla `GET`-päätepisteellä.
Valitse tyypit `enabled_events`-kentällä. Lähetä `["*"]`, niin saat kaikki tyypit, myös myöhemmin lisätyt.

| Tyyppi | Milloin se lähetetään |
| - | - |
| `appointment.created` | Ajanvaraus tulee sinulle näkyviin. Lähetetään kerran ajanvarausta kohden. |
| `appointment.pending` | Ajanvaraus siirtyy tilaan `pending`. |
| `appointment.confirmed` | Ajanvaraus siirtyy tilaan `confirmed`. |
| `appointment.blood_drawn` | Ajanvaraus siirtyy tilaan `blood_drawn`. |
| `appointment.cancelled` | Ajanvaraus siirtyy tilaan `cancelled`. |
| `appointment.rescheduled` | `scheduled_at` tai toimipiste muuttuu. Ei lähetetä, kun ajanvaraus on tilassa `cancelled`. |
| `appointment.results.updated` | Tulokset muuttuvat. |
| `appointment.results.completed` | Tulosten `status` siirtyy tilaan `completed`. |
| `appointment.results.fault` | Tulosten `status` siirtyy tilaan `fault`. |
| `home_kit_order.created` | Tilaus luodaan. Lähetetään kerran tilausta kohden. |
| `home_kit_order.pending` | Tilaus siirtyy tilaan `pending`. |
| `home_kit_order.dispatched` | Tilaus siirtyy tilaan `dispatched`. |
| `home_kit_order.activated` | Tilaus siirtyy tilaan `activated`. |
| `home_kit_order.cancelled` | Tilaus siirtyy tilaan `cancelled`. |
| `home_kit_order.results.updated` | Tulokset muuttuvat. |
| `home_kit_order.results.completed` | Tulosten `status` siirtyy tilaan `completed`. |
| `home_kit_order.results.fault` | Tulosten `status` siirtyy tilaan `fault`. |
| `document.results.updated` | Lataamasi dokumentin tulokset muuttuvat tai se tallennetaan. `stored` on lopullinen: `document.results.completed` ei seuraa. |
| `document.results.completed` | Lataamasi dokumentin tulosten `status` siirtyy tilaan `completed`. |
| `document.results.fault` | Lataamasi dokumentin tulosten `status` siirtyy tilaan `fault`. |
| `document.deleted` | Lataamasi dokumentti poistetaan. Lähetetään päätepisteille, jotka saivat sen viimeisimmän tulostapahtuman. Ei `url`-kenttää. |
| `location.created` | Toimipiste tulee sinulle näkyviin: uusi, aktivoitu tai lisätty lukemaasi ryhmään. |
| `location.updated` | Mikä tahansa toimipisteen kenttä muuttuu: nimi, osoite, verkkosivusto, aukioloajat, kuva. |
| `location.deactivated` | Et voi enää lukea toimipistettä. |
| `location.retail_prices.updated` | Julkaistun paneelin tai biomarkkerin hinta toimipisteessä muuttuu. Vaatii `retail_prices_view`-oikeuden. |
| `profile.created` | Profiili tulee sinulle näkyviin: uusi tai lisätty lukemaasi profiiliryhmään. |
| `profile.updated` | Mikä tahansa kenttä muuttuu kohdassa [Hae profiili](https://docs.anivahealth.com/fi/api/profiles/get-profile.md). |
| `profile.deleted` | Profiili poistetaan tai et voi enää lukea sitä. |
| `shipment.created` | Lähetys tulee sinulle näkyviin. |
| `shipment.updated` | Mikä tahansa lähetyksen kenttä muuttuu: seuranta, skannaukset, nouto, huomautukset, linkit. |
| `shipment.pending` | Lähetys siirtyy tilaan `pending`. |
| `shipment.in_transit` | Lähetys siirtyy tilaan `in_transit`. |
| `shipment.delivered` | Lähetys siirtyy tilaan `delivered`. |
| `shipment.fault` | Lähetys siirtyy tilaan `fault`. |
| `shipment.cancelled` | Lähetys siirtyy tilaan `cancelled`. |
| `ping` | Lähetit testitapahtuman. Lähetetään aina, ei kuulu `enabled_events`-kenttään. |

* Tilatapahtuma lähetetään jokaisesta siirtymästä kyseiseen tilaan, myös paluusta takaisin. Esimerkiksi
  kotitestipakkaus, joka palaa tilasta `dispatched` tilaan `pending`, lähettää tapahtuman `home_kit_order.pending`.
* Yksi muutos voi lähettää kaksi tapahtumaa samalla `status_revision`-arvolla, esimerkiksi
  `appointment.confirmed` ja `appointment.rescheduled`.
* `results.updated` lähetetään jokaisesta tulosten muutoksesta: uudesta arvosta, korjauksesta, virheestä, uudesta
  tai korvatusta dokumentista tai näytteestä, joka poistuu objektista. Se saapuu muutaman minuutin kuluessa
  viimeisimmästä muutoksesta.
* `results.completed` ja `results.fault` tulevat aina yhdessä `results.updated`-tapahtuman kanssa, jolla on sama
  `results_revision`. Tulokset voidaan avata uudelleen ja merkitä jälleen valmiiksi, joten voit saada toisen
  `results.completed`-tapahtuman.

Tilaa `results.updated`, jos haluat näyttää osittaiset tulokset, tai `results.completed`, jos haluat reagoida vain
lopullisiin tuloksiin.

`results.completed` seuraa tulosarvoja, ei PDF-tiedostoa. Raportin PDF voi saapua ennen arvoja tai
niiden jälkeen. Jotkin laboratoriot lähettävät ensin alustavan PDF-tiedoston ja korvaavat sen myöhemmin lopullisella
samalla dokumentin `id`-tunnuksella. Korvaaminen lähettää tapahtuman `results.updated`. Erota nämä kaksi toisistaan
lukemalla `documents[].original_file_name`: Labor Quade päättää alustavan raportin (Vorbefund) merkintään `_V`
ja lopullisen raportin (Endbefund) merkintään `_E`, esimerkiksi
`7642100312_B0012_FA_E.pdf`.

Toimipiste-, profiili- ja lähetystapahtumat saapuvat muutaman minuutin kuluessa. Aniva odottaa, kunnes objekti ei
ole muuttunut 2 minuuttiin, joten sarja muokkauksia lähettää yhden tapahtuman. Myös nämä säännöt pätevät:

* Anonyymit profiilit eivät lähetä tapahtumia.
* Lähetys ei lähetä tapahtumaa, kun menetät pääsyn siihen.
* Lähetyksen tilan muutos lähettää tapahtuman `shipment.updated` ja tapahtuman `shipment.<status>` samalla
  `revision`-arvolla.

## Tietosisältö

| Kenttä | Kuvaus |
| - | - |
| `id` | Tapahtuman tunnus (UUID). Sama kuin `webhook-id`-otsake. Pysyy samana uudelleenyrityksessä ja uudelleenlähetyksessä. |
| `type` | Tapahtuman tyyppi, esimerkiksi `appointment.confirmed`. |
| `timestamp` | Milloin muutos tapahtui, ISO 8601 UTC -aikaleimana. Ei lähetysaika. |
| `data` | Muuttunut objekti. Rakenne riippuu tapahtuman tyypistä. |

### Tilatapahtuman tiedot

| Kenttä | Kuvaus |
| - | - |
| `object` | `appointment` tai `home_kit_order`. |
| `id` | Ajanvarauksen tai kotitestipakkauksen tilauksen tunnus (UUID). |
| `url` | `/api/v1/appointments/{id}` tai `/api/v1/home-kit-orders/{id}`. |
| `status` | Tila muutoksen jälkeen. |
| `previous_status` | Tila ennen muutosta. `null` tapahtumassa `created`. |
| `status_revision` | Objektikohtainen laskuri. Kasvaa jokaisesta tilan muutoksesta ja voi hypätä numeroiden yli. |

```json appointment.confirmed theme={null}
{
  "id": "0b8e6f3a-2c4d-4e7f-9a1b-3c5d7e9f1a2b",
  "type": "appointment.confirmed",
  "timestamp": "2026-10-15T09:12:44.512Z",
  "data": {
    "object": "appointment",
    "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
    "url": "https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
    "status": "confirmed",
    "previous_status": "pending",
    "status_revision": 2
  }
}
```

### Tulostapahtuman tiedot

| Kenttä | Kuvaus |
| - | - |
| `object` | `appointment`, `home_kit_order` tai `document`. |
| `id` | Ajanvarauksen, kotitestipakkauksen tilauksen tai dokumentin tunnus (UUID). |
| `url` | Objektin `/results`-reitti, esim. `/api/v1/documents/{id}/results`. |
| `results_status` | `in_progress`, `completed` tai `fault`. Dokumentti voi olla myös `stored`. |
| `previous_results_status` | Edellisen tulostapahtuman `results_status`. `null` ensimmäisessä tapahtumassa. |
| `results_revision` | Objektikohtainen laskuri. Kasvaa jokaisesta tulosten muutoksesta ja voi hypätä numeroiden yli. |

```json home_kit_order.results.completed theme={null}
{
  "id": "6d2a9c4e-8f1b-4a3d-b5e7-0c2f4a6b8d1e",
  "type": "home_kit_order.results.completed",
  "timestamp": "2026-10-15T14:03:00.000Z",
  "data": {
    "object": "home_kit_order",
    "id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
    "url": "https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results",
    "results_status": "completed",
    "previous_results_status": "in_progress",
    "results_revision": 4
  }
}
```

### Dokumentin poistotapahtuman tiedot

`document.deleted` sisältää kentät `object` (`document`), `id`, `previous_results_status` ja
`results_revision`. Siinä ei ole `url`-kenttää, koska mitään luettavaa ei ole jäljellä.

```json document.deleted theme={null}
{
  "id": "1c9e7a52-3f4b-4d8a-9e61-7b2c5d0f8a14",
  "type": "document.deleted",
  "timestamp": "2026-10-24T09:12:00.000Z",
  "data": {
    "object": "document",
    "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
    "previous_results_status": "completed",
    "results_revision": 3
  }
}
```

### Toimipiste-, profiili- ja lähetystapahtuman tiedot

| Kenttä | Kuvaus |
| - | - |
| `object` | `location`, `profile` tai `shipment`. |
| `id` | Toimipisteen tai profiilin tunnus (UUID) tai lähetyksen viite. |
| `url` | `/api/v1/locations/{id}`, `/api/v1/locations/{id}/retail-prices`, `/api/v1/profiles/{id}` tai `/api/v1/shipments/{id}`. Puuttuu `.deactivated`- ja `.deleted`-tapahtumissa. |
| `status` | Vain lähetyksille. Tila muutoksen jälkeen. |
| `previous_status` | Vain lähetyksille. Tila ennen muutosta. `null` tapahtumassa `shipment.created`. |
| `revision` | Objektikohtainen laskuri kaikille sen tapahtumille. Voi hypätä numeroiden yli. Vähittäishintatapahtumilla on oma laskurinsa. |

```json shipment.in_transit theme={null}
{
  "id": "3f7c1a2b-9d4e-4b6a-8c5f-2e1d0a9b8c7d",
  "type": "shipment.in_transit",
  "timestamp": "2026-10-16T08:41:12.000Z",
  "data": {
    "object": "shipment",
    "id": "P2610164821",
    "url": "https://anivahealth.com/api/v1/shipments/P2610164821",
    "status": "in_transit",
    "previous_status": "pending",
    "revision": 3
  }
}
```

`ping` sisältää kentän `data.object` arvolla `webhook` ja kentän `data.id`, joka on webhookin tunnus.

## Vahvista allekirjoitus

Tapahtumat eivät sisällä dataa, mutta jokainen niistä kannattaa silti vahvistaa. Kelvollinen allekirjoitus todistaa, että
tapahtuma tuli Anivalta. Jokainen pyyntö sisältää otsakkeet `webhook-id`, `webhook-timestamp` (Unix-
sekunteina) ja `webhook-signature`.

1. Ota pyynnön raakarunko. Vahvista se ennen JSON:n jäsentämistä.
2. Muodosta allekirjoitettava sisältö `{webhook-id}.{webhook-timestamp}.{raw body}`.
3. Dekoodaa salaisuutesi `whsec_`-etuliitteen jälkeinen osa base64-muodosta. Käytä sitä avaimena.
4. Laske allekirjoitettavan sisällön HMAC-SHA256 ja koodaa se base64-muotoon.
5. Vertaa sitä vakioajassa jokaiseen `webhook-signature`-otsakkeen `v1,<signature>`-merkintään. Merkinnät
   erotetaan välilyönneillä. Yksi osuma riittää.
6. Hylkää pyyntö, jos `webhook-timestamp` eroaa kellostasi yli 5 minuuttia.

```typescript Node.js theme={null}
import { createHmac, timingSafeEqual } from 'node:crypto';

export function verifyAnivaWebhook(rawBody: string, headers: Headers, secret: string): boolean {
  const id = headers.get('webhook-id') ?? '';
  const timestamp = headers.get('webhook-timestamp') ?? '';
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;

  const key = Buffer.from(secret.slice('whsec_'.length), 'base64');
  const expected = createHmac('sha256', key).update(`${id}.${timestamp}.${rawBody}`).digest();

  return (headers.get('webhook-signature') ?? '').split(' ').some((entry) => {
    const [version, signature = ''] = entry.split(',');
    const received = Buffer.from(signature, 'base64');
    return (
      version === 'v1' && received.length === expected.length && timingSafeEqual(received, expected)
    );
  });
}
```

Menetelmänä on [Standard Webhooks](https://www.standardwebhooks.com). Useimmille kielille on
Standard Webhooks -kirjastoja, jotka tekevät tämän yhdellä kutsulla.

### Kierrätä salaisuus

Kutsu [Vaihda salaisuus](https://docs.anivahealth.com/fi/api/webhooks/rotate-secret.md) -päätepistettä saadaksesi uuden salaisuuden. Aniva
allekirjoittaa 24 tunnin ajan sekä vanhalla että uudella salaisuudella, joten ota uusi käyttöön sen aikana. Vuodon jälkeen lähetä
`revoke_current_secret_now: true` poistaaksesi vanhan salaisuuden käytöstä heti.

## Toimitus

* Vastaa `2xx`-koodilla 15 sekunnin kuluessa. Tallenna tapahtuma tai lisää se jonoon ja käsittele se myöhemmin.
* Käytä julkisen palvelimen `https`-URL-osoitetta portissa 443. Aniva ei seuraa uudelleenohjauksia: `3xx`
  lasketaan virheeksi.
* Toimitus tapahtuu vähintään kerran ilman taattua järjestystä. Hylkää kaksoiskappaleet `webhook-id`-tunnisteen avulla. Ohita vanhempi tapahtuma
  revisioiden avulla.
* Vastaa `410 Gone` lopettaaksesi tapahtumat. Aniva poistaa webhookin käytöstä heti.
* Aniva säilyttää toimitukset 30 päivää. Sen jälkeen et voi listata tai lähettää niitä uudelleen.

### Uudelleenyritykset

Muu kuin `2xx`-vastaus, aikakatkaisu tai verkkovirhe käynnistää uudelleenyrityksen. Kutakin tapahtumaa yritetään enintään 10 kertaa
noin kolmen päivän aikana:

| Yritys | Aika ensimmäisen yrityksen jälkeen |
| - | - |
| 2 | noin 5 sekuntia |
| 3 | noin 5 minuuttia |
| 4 | noin 35 minuuttia |
| 5 | noin 2,5 tuntia |
| 6 | noin 7,5 tuntia |
| 7 | noin 17,5 tuntia |
| 8 | noin 27,5 tuntia |
| 9 | noin 51,5 tuntia |
| 10 | noin 75,5 tuntia |

Yrityksen 10 jälkeen toimituksen tila on `failed`. Lähetä se uudelleen
[Lähetä toimitus uudelleen](https://docs.anivahealth.com/fi/api/webhooks/resend-delivery.md) -päätepisteellä. Sen `webhook-id` pysyy samana.

### Virheilmoitukset

Aniva lähettää sähköpostia webhookin `alert_emails`-osoitteisiin, kun yksikään toimitus ei ole onnistunut 24 tuntiin, kun tapahtuman tila on
`failed` ja kun webhook poistetaan käytöstä. Kun 5 päivää on kulunut ilman onnistunutta toimitusta, Aniva
poistaa webhookin käytöstä. Käytöstä poistettu webhook ei saa uusia tapahtumia, ja sen odottavat toimitukset
perutaan.

| `disabled_reason` | Syy |
| - | - |
| `Disabled by the partner` | Lähetit `status: "disabled"`. |
| `Disabled by Aniva` | Aniva poisti webhookin käytöstä. Vain Aniva voi ottaa sen uudelleen käyttöön. |
| `The endpoint answered 410 Gone` | Päätepisteesi vastasi `410 Gone`. |
| `No successful delivery for 5 days` | Yksikään toimitus ei onnistunut 5 päivään. |

Aloita uudelleen korjaamalla päätepisteesi ja lähettämällä `status: "enabled"`
[Päivitä webhook](https://docs.anivahealth.com/fi/api/webhooks/update-webhook.md) -päätepisteellä. Väliin jääneitä tapahtumia ei lähetetä
uudelleen automaattisesti. Lähetä ne uudelleen tai lue nykytila `GET`-päätepisteistä.

## Toistuvat haut

Aniva tallentaa joidenkin `GET`-päätepisteiden vastauksen lyhyeksi ajaksi. Kun API-avaimesi lähettää saman
pyynnön uudelleen tämän ajan kuluessa, saat tallennetun vastauksen. Et saa virhettä, ja vastauksen runko on
samassa muodossa.

* **Yksi tietue** (lähetys, kotitestipakkaustilaus, ajanvaraus ja kahden viimeksi mainitun tulokset):
  Aniva tarkistaa jokaisella kutsulla, ettei tietue ole muuttunut. Jos se on muuttunut, saat tuoreen vastauksen.
* **Lista** voi olla vanhempi kuin sen tietueet, enintään 5 minuuttia.

Saat tiedon muutoksesta heti käyttämällä taulukon webhook-tapahtumia.

| Päätepiste | Tallennusaika | Muutoksesta kertovat tapahtumat |
| - | - | - |
| [Hae lähetys](https://docs.anivahealth.com/fi/api/shipments/get-shipment.md) | 60 minuuttia | `shipment.created`, `shipment.updated` |
| [Listaa lähetykset](https://docs.anivahealth.com/fi/api/shipments/list-shipments.md) | 5 minuuttia | `shipment.created`, `shipment.updated` |
| [Hae kotitestipakkaustilaus](https://docs.anivahealth.com/fi/api/home-kit-orders/get-home-kit.md) | 60 minuuttia | `home_kit_order.created` ja yksi tapahtuma tilaa kohden, esimerkiksi `home_kit_order.activated` |
| [Hae kotitestipakkaustilauksen tulokset](https://docs.anivahealth.com/fi/api/home-kit-orders/get-results.md) | 60 minuuttia | `home_kit_order.results.updated`, `.completed`, `.fault` |
| [Listaa kotitestipakkaustilaukset](https://docs.anivahealth.com/fi/api/home-kit-orders/list-home-kits.md) | 5 minuuttia | samat tapahtumat kuin yhdelle kotitestipakkaustilaukselle |
| [Hae ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/get-appointment.md) | 15 minuuttia | `appointment.created`, `appointment.rescheduled` ja yksi tapahtuma tilaa kohden, esimerkiksi `appointment.confirmed` |
| [Hae ajanvarauksen tulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) | 60 minuuttia | `appointment.results.updated`, `.completed`, `.fault` |
| [Listaa ajanvaraukset](https://docs.anivahealth.com/fi/api/appointments/list-appointments.md) | 5 minuuttia | samat tapahtumat kuin yhdelle ajanvaraukselle |
| [Listaa profiilit](https://docs.anivahealth.com/fi/api/profiles/list-profiles.md) | 5 minuuttia | `profile.created`, `profile.updated`, `profile.deleted` |

* Sama pyyntö tarkoittaa samaa API-avainta, samaa päätepistettä ja samoja kyselyparametreja. Listan
  toinen sivu on eri pyyntö ja saa oman vastauksensa.
* Aniva tallentaa vain `200`-vastauksen. Virhettä ei tallenneta koskaan.
* Aika alkaa, kun Aniva tallentaa vastauksen. Myöhempi kutsu ei pidennä sitä.
* Kun API-avaimesi luo, päivittää, aktivoi tai peruu jotakin, seuraava hakusi on tuore.
  Myös toisella API-avaimellasi tehty seuraava haku kyseisestä tietueesta on tuore.
* Tallennetussa lähetysvastauksessa kentät `synced_at` ja `updated_at` voivat olla vanhempia kuin
  tuoreessa vastauksessa. Tila, seuranta ja osoitteet ovat ajantasaisia.
* Tallennetussa tulosvastauksessa biomarkkerin nimi, yksikkö tai muunnettu arvo voi olla enintään 60
  minuuttia vanha sen jälkeen, kun Aniva muuttaa luetteloaan. Mitatut arvot ovat ajantasaisia.
* Kun Aniva luo webhook-tapahtuman webhookillesi, seuraava kyseisen tietueen, sen
  tulosten ja sen listojen haku on tuore. Näin tapahtumaa seuraava haku näyttää aina muutoksen.

### Vastausotsakkeet

Jokaisessa näiden päätepisteiden vastauksessa kelvolliselle API-avaimelle on nämä otsakkeet:

| Otsake | Lähetetään | Merkitys |
| - | - | - |
| `Aniva-Webhook-Events` | Jokaisessa vastauksessa | Päätepistettä koskevat webhook-tapahtumat pilkuilla erotettuina. |
| `Link` | Jokaisessa vastauksessa | Tämän sivun osoite arvolla `rel="help"`. |
| `Cache-Status` | `200`-vastauksessa | `Aniva; hit; ttl=3476` on tallennettu vastaus. `ttl` on sekuntimäärä siihen, kun tuore vastaus on saatavilla. `Aniva; fwd=miss; stored; ttl=3600` on tuore vastaus, jonka Aniva tallensi nyt. `Aniva; fwd=miss` on tuore vastaus, jota Aniva ei tallentanut. |
| `Age` | Tallennetussa vastauksessa | Tallennetun vastauksen ikä sekunteina. |
| `Cache-Control` | `200`-vastauksessa | `private, no-cache`. Älä säilytä vastausta omassa välimuistissasi Anivan kutsumisen sijaan. |

```http theme={null}
HTTP/1.1 200 OK
Age: 124
Cache-Status: Aniva; hit; ttl=3476
Cache-Control: private, no-cache
Aniva-Webhook-Events: shipment.created, shipment.updated
Link: <https://docs.anivahealth.com/concepts/webhooks>; rel="help"
```

## Parhaat käytännöt

* **Hylkää kaksoiskappaleet.** Ohita tapahtuma, jonka `webhook-id`-tunnisteen olet jo käsitellyt.
* **Käytä revisioita.** Tallenna suurin `status_revision`, `results_revision` ja `revision`
  kohdekohtaisesti. Ohita tapahtuma, jossa arvo on pienempi.
* **Hae `url`.** Tapahtuma kertoo, että jokin muuttui. `GET`-päätepiste kertoo, mikä muuttui.
* **Vastaa nopeasti.** Lisää tapahtuma jonoon ja vastaa `2xx`-koodilla ennen sen käsittelyä.
* **Täsmäytä.** Aja säännöllinen tehtävä, joka lukee avoimet kohteet `GET`-päätepisteistä. Kysely pysyy
  kelvollisena vararatkaisuna. Toistuva haku voi saada tallennetun vastauksen, katso [Toistuvat haut](#toistuvat-haut).
* **Testaa jokaisen julkaisun jälkeen.** Käytä [Lähetä testitapahtuma](https://docs.anivahealth.com/fi/api/webhooks/send-test-event.md) -päätepistettä.


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