Saltar al contingut principal

Tipus d'esdeveniments de webhook

vitalera envia notificacions webhook per als tipus d'esdeveniment següents. Cada esdeveniment inclou una càrrega útil estructurada que conté les dades del recurs afectat.

Convenció de noms d'esdeveniments​

Els tipus d'esdeveniment segueixen el patró <recurs>.<acció>:

  • <recurs> -- el recurs FHIR o objecte de domini (minúscules, snake_case)
  • <acció> -- l'esdeveniment del cicle de vida (created, updated, deleted)

Esdeveniments disponibles​

Esdeveniments d'observació​

S'activen quan es registren o actualitzen mesures de salut dels pacients.

Tipus d'esdevenimentDescripció
observation.createdEs va registrar una nova observació (constant vital, mesura)
observation.updatedEs va modificar una observació existent

Exemple de càrrega útil:

{
  "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"
        }
      }
    ]
  }
}

Esdeveniments de pla de cures​

S'activen quan es creen, modifiquen o canvia l'estat dels plans de cures.

Tipus d'esdevenimentDescripció
plan.createdEs va crear un nou pla de cures
plan.updatedEs va modificar un pla de cures (programació, components)
plan.activatedEs va activar un pla de cures per a un pacient
plan.completedUn pla de cures va arribar a la seva data de fi

Esdeveniments de resposta a qüestionaris​

S'activen quan els pacients envien respostes a qüestionaris.

Tipus d'esdevenimentDescripció
questionnaire_response.createdUn pacient va enviar un qüestionari

Esdeveniments de tasques​

S'activen quan s'assignen, completen o canvia l'estat de les tasques.

Tipus d'esdevenimentDescripció
task.createdEs va assignar una nova tasca a un pacient
task.updatedEs van canviar l'estat o detalls d'una tasca
task.completedUna tasca es va marcar com a completada

Esdeveniments d'alarma​

S'activen quan es generen o resolen alarmes clíniques.

Tipus d'esdevenimentDescripció
alarm.triggeredUna regla d'alarma va ser activada per les dades d'un pacient
alarm.resolvedUna alarma prèviament activada va ser resolta

Esdeveniments de consentiment​

S'activen quan canvien els registres de consentiment dels pacients.

Tipus d'esdevenimentDescripció
consent.grantedUn pacient va atorgar consentiment
consent.revokedUn pacient va revocar un consentiment atorgat prèviament

Camps comuns de la càrrega útil​

Cada càrrega útil de webhook inclou aquests camps de nivell superior:

CampTipusDescripció
event_typestringL'identificador del tipus d'esdeveniment (vegeu les taules anteriors)
timestampstringMarca de temps ISO 8601 de quan es va produir l'esdeveniment
dataobjectLes dades del recurs associades amb l'esdeveniment

Filtratge d'esdeveniments​

Quan configureu el vostre punt d'accés de webhook, podeu seleccionar quins tipus d'esdeveniment voleu rebre. Això redueix el soroll i assegura que la vostra aplicació només processi esdeveniments rellevants.

Passos següents​