Webhook gertaera motak

vitalera-k ondorengo gertaera motetarako webhook jakinarazpenak bidaltzen ditu. Gertaera bakoitzak eragindako baliabidearen datuak dituen karga egituratua biltzen du.

Gertaera-izen konbentzioa

Gertaera motek <baliabidea>.<ekintza> eredua jarraitzen dute:

• <baliabidea> -- FHIR baliabidea edo domeinu-objektua (minuskula, snake_case)
• <ekintza> -- bizi-zikloko gertaera (created, updated, deleted)

Gertaera erabilgarriak

Behaketa-gertaerak

Pazienteen osasun-neurriak erregistratzen edo eguneratzen direnean aktibatzen dira.

Gertaera mota	Deskribapena
observation.created	Behaketa berri bat (bizi-konstantea, neurketa) erregistratu da
observation.updated	Lehendik dagoen behaketa bat aldatu da

Karga adibidea:

{
  "event_type": "observation.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": 810,
    "resourceType": "Observation",
    "status": "final",
    "code": {
      "coding": [
        {
          "system": "http://loinc.org",
          "code": "85354-9",
          "display": "Blood pressure panel"
        }
      ]
    },
    "subject": {
      "reference": "Patient/456"
    },
    "effectiveDateTime": "2024-01-15T10:29:45Z",
    "component": [
      {
        "code": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "8480-6",
              "display": "Systolic blood pressure"
            }
          ]
        },
        "valueQuantity": {
          "value": 120,
          "unit": "mmHg"
        }
      },
      {
        "code": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "8462-4",
              "display": "Diastolic blood pressure"
            }
          ]
        },
        "valueQuantity": {
          "value": 80,
          "unit": "mmHg"
        }
      }
    ]
  }
}

Zainketa-plan gertaerak

Zainketa-planak sortzen, aldatzen edo egoera aldatzen denean aktibatzen dira.

Gertaera mota	Deskribapena
plan.created	Zainketa-plan berri bat sortu da
plan.updated	Zainketa-plan bat aldatu da (egutegia, osagaiak)
plan.activated	Zainketa-plan bat paziente batentzat aktibatu da
plan.completed	Zainketa-plan batek amaiera-data heldu du

Karga adibidea:

{
  "event_type": "plan.updated",
  "timestamp": "2024-01-15T14:00:00Z",
  "data": {
    "id": 55,
    "resourceType": "CarePlan",
    "status": "active",
    "subject": {
      "reference": "Patient/456"
    },
    "period": {
      "start": "2024-01-01",
      "end": "2024-03-31"
    }
  }
}

Galdetegi-erantzun gertaerak

Pazienteek galdetegi-erantzunak bidaltzen dituztenean aktibatzen dira.

Gertaera mota	Deskribapena
questionnaire_response.created	Paziente batek galdetegi bat bidali du

Karga adibidea:

{
  "event_type": "questionnaire_response.created",
  "timestamp": "2024-01-15T11:00:00Z",
  "data": {
    "id": 1200,
    "resourceType": "QuestionnaireResponse",
    "status": "completed",
    "questionnaire": "Questionnaire/42",
    "subject": {
      "reference": "Patient/456"
    },
    "authored": "2024-01-15T10:58:30Z",
    "item": [
      {
        "linkId": "q1",
        "answer": [
          {
            "valueInteger": 2
          }
        ]
      }
    ]
  }
}

Zeregin-gertaerak

Zereginak esleitzen, osatzen edo egoera aldatzen denean aktibatzen dira.

Gertaera mota	Deskribapena
task.created	Zeregin berri bat paziente bati esleitu zaio
task.updated	Zeregin baten egoera edo xehetasunak aldatu dira
task.completed	Zeregin bat osatu gisa markatu da

Alarma-gertaerak

Alarma klinikoak altxatzen edo ebazten direnean aktibatzen dira.

Gertaera mota	Deskribapena
alarm.triggered	Alarma-arau bat pazientearen datuek aktibatu dute
alarm.resolved	Aurretik aktibatutako alarma bat ebatzi da

Karga adibidea:

{
  "event_type": "alarm.triggered",
  "timestamp": "2024-01-15T10:31:00Z",
  "data": {
    "id": 3001,
    "alarm_rule_id": 15,
    "patient": {
      "reference": "Patient/456"
    },
    "severity": "high",
    "message": "Systolic blood pressure above threshold (140 mmHg)",
    "observation": {
      "reference": "Observation/810"
    }
  }
}

Adostasun-gertaerak

Pazienteen adostasun-erregistroak aldatzen direnean aktibatzen dira.

Gertaera mota	Deskribapena
consent.granted	Paziente batek adostasuna eman du
consent.revoked	Paziente batek aurretik emandako adostasuna errebokatu du

Kargaren eremu komunak

Webhook karga guztiek goi-mailako eremu hauek biltzen dituzte:

Eremua	Mota	Deskribapena
event_type	string	Gertaera mota identifikatzailea (ikusi goiko taulak)
timestamp	string	Gertaera noiz gertatu zen ISO 8601 denbora-zigilu gisa
data	object	Gertaerarekin lotutako baliabidearen datuak

Gertaerak iragaztea

Zure webhook amaiera-puntua konfiguratzen duzunean, hautatu zein gertaera mota jaso nahi dituzun. Honek zarata murrizten du eta zure aplikazioak gertaera garrantzitsuak soilik prozesatzen dituela bermatzen du.

Hurrengo urratsak

• Webhook-en ikuspegi orokorra -- Webhook-ak nola funtzionatzen duten eta nola konfiguratu
• Sinadura-egiaztapena -- Webhook-aren benetakotasuna egiaztatu