Ugrás a fő tartalomra

Webhook-ok áttekintése

Mik azok a webhook-ok?​

A webhook-ok lehetővé teszik a vitalera számára, hogy valós idejű értesítéseket küldjön az alkalmazásába, amikor specifikus események történnek. Ahelyett, hogy az API-t lekérdezné a változásokért, a webhook-ok azonnal az Ön végpontjára küldik az adatokat, amint az események megtörténnek.

Hogyan működik?​

  1. Konfiguráljon egy webhook URL-t a vitalera szervezeti beállításaiban
  2. Válassza ki az eseménytípusokat, amelyeket fogadni szeretne
  3. Opcionálisan állítson be egy titkos kulcsot az aláírás-ellenőrzéshez
  4. A vitalera HTTP POST kéréseket küld az Ön URL-jére, amikor események történnek

Webhook hasznos adat​

Az összes webhook hasznos adat egységes struktúrát követ:

{
  "event_type": "observation.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": 810,
    "resourceType": "Observation",
    "...": "..."
  }
}

Biztonság​

  • Minden webhook hívás tartalmaz egy x-webhook-humanai-signature fejlécet az ellenőrzéshez
  • Kizárólag HTTPS végpontokat használjon
  • Állítson be egyedi titkos kulcsot minden webhook konfigurációhoz
  • A megvalósítás részleteiért lásd az Aláírás-ellenőrzés oldalt

Újrapróbálkozási szabályzat​

Ha az Ön végpontja nem 2xx választ ad vissza, a vitalera exponenciális visszalépéssel újrapróbálja a webhook kézbesítést.

Következő lépések​