Webhooks

Xyrelis manda un POST JSON a su URL (https, servidor público) cuando ocurre un evento. Responda con un 2xx en menos de 10 s; tras 20 fallos seguidos el webhook se desactiva.

`cuaderno.cambio`	Se ha anotado algo en el cuaderno por la API
`stock.bajo`	Un artículo del almacén ha bajado del mínimo
`siniestro.nuevo`	Se ha abierto un expediente de siniestro
`parte.hecho`	Un trabajador ha terminado un parte de trabajo
`prueba`	Envío de prueba desde el portal

POST /su-url
X-Xyrelis-Evento: stock.bajo
X-Xyrelis-Firma: sha256=…
{"evento": "stock.bajo", "fecha": "2026-10-27T10:00:00Z", "id": "a1b2…", "datos": {"articulo_id": 3, "nombre": "…", "stock": 2.5, "minimo": 5}}

Comprobar la firma

import hmac, hashlib
def es_de_xyrelis(cuerpo: bytes, cabecera: str, secreto: str) -> bool:
    esperada = "sha256=" + hmac.new(secreto.encode(), cuerpo, hashlib.sha256).hexdigest()
    return hmac.compare_digest(esperada, cabecera)