RECURSO DE LA API

Webhooks

A medida que ocurren eventos en su clínica, se envía una notificación firmada a su dirección registrada; mantiene su propio sistema actualizado al instante.

Acceso anticipado Toda la API

Endpoints

3 endpoint

Endpoints de este recurso. Cada endpoint se limita a los datos de la clínica a la que está vinculada la clave de la API; los endpoints de escritura admiten la cabecera Idempotency-Key.

GET /v1/webhooks Lista las suscripciones de webhook registradas admin

POST /v1/webhooks Registra un webhook para la notificación de eventos admin

DELETE /v1/webhooks/{id} Elimina la suscripción de webhook admin

Ejemplo de uso

Registrar webhook

Solicitud

curl -X POST https://api.udentiva.com/v1/webhooks \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://siz.example/hook","events":["payment.created"]}'

Respuesta

HTTP/1.1 201 Created
{
  "id": "wh-1",
  "url": "https://siz.example/hook",
  "events": ["payment.created"],
  "secret": "whsec_xxx"
}

Seguridad en este recurso

La seguridad no es una función, es la propia arquitectura. Las garantías vigentes en este recurso:

Cada notificación se firma con la clave secreta compartida (HMAC); al verificar la firma confirma que la solicitud proviene realmente de UDENTIVA.

Reenvío seguro: cada evento tiene un identificador único; puede descartar las entregas duplicadas a partir del identificador (consumo idempotente).

Las suscripciones de webhook están aisladas en su clínica; solo recibe sus propios eventos.

Todo el modelo de seguridad →

Formato de error

Los errores se devuelven con un sobre coherente; el código va dirigido a la máquina, el mensaje al usuario. El error interno o el stack nunca se filtran.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo no válido: correo electrónico"
  }
}

Otros recursos

Pacientes Citas y calendario Odontograma y Tratamiento Cobros y finanzas Inventario Imágenes Laboratorio Lead y CRM Turismo de salud Informes y BI Transferencia de Datos (Export API)

¿Quiere acceso anticipado?

Sea el primero en enterarse cuando se abra la API.

Contactar