API pública, versión 1

Extra de 19 € al mes sin IVA en Secretaria, Recepción y Max. En Secretaria expone solicitudes de cita y recados, y no escribe en la agenda: pedir citas responde 403. Sin el extra, la respuesta es 403. Lee las llamadas (solo metadatos), los recados, las solicitudes y, fuera de Secretaria, las citas, y recibe un aviso firmado cuando termina una llamada, entra un recado o se crea o anula una cita.

Clave

La creas en el panel, en API, cuando el extra está activo. Se muestra una sola vez: en el servidor solo queda el hash. Si la pierdes, crea otra y revoca la antigua.

curl -s https://su-dominio/api/v1/llamadas \
  -H "Authorization: Bearer rci_…"

Una clave revocada o de otra clínica no entra. Sin el extra, o en Secretaria, la respuesta es 403.

Límite

60 peticiones por minuto y por clave. Si se pasa, la respuesta es 429 y la cabecera Retry-After dice cuántos segundos faltan. También van X-RateLimit-Limit y X-RateLimit-Remaining.

Psicología

La API no entrega la transcripción de la llamada. En psicología, tampoco si ese texto se hubiera colado en el resumen o en otro campo. El motivo que sale es el operativo (quién llama y para qué), no una nota clínica.

Rutas

  • GET/api/v1/llamadasMetadatos de las llamadas.
  • GET/api/v1/llamadas/{id}Metadatos de una llamada.
  • GET/api/v1/recadosRecados tomados por la recepcionista.
  • GET/api/v1/recados/{id}Un recado.
  • GET/api/v1/solicitudesSolicitudes de cita.
  • GET/api/v1/solicitudes/{id}Una solicitud de cita.
  • GET/api/v1/citasCitas de la agenda.
  • GET/api/v1/citas/{id}Una cita. En Secretaria responde 403: la API no escribe en la agenda.
  • GET/api/v1/webhooksWebhooks de la clínica, sin el secreto.
  • POST/api/v1/webhooksDa de alta un webhook. El secreto se enseña una sola vez.
  • DELETE/api/v1/webhooks/{id}Revoca un webhook.

Las listas aceptan limite (1 a 100) y cursor. Las fechas van en desde y hasta.

Webhooks

Se dan de alta con la clave o desde el panel. La dirección tiene que ser https. El secreto de firma se enseña una sola vez y no viaja en las lecturas.

  • llamada.terminada
  • recado.nuevo
  • cita.creada
  • cita.anulada

Cada aviso es un POST con el JSON en el cuerpo. La cabecera X-Rci-Firma vale t=unix,v1=hex. El hex es HMAC-SHA256 de `${t}.${cuerpo crudo}` con el secreto del webhook. Rechaza una marca de más de cinco minutos.

Un 2xx se da por entregado. Un corte de red, un 408, un 429 o un 5xx se reintenta hasta 5 veces: al momento, al minuto, a los cinco minutos, a la media hora y a las dos horas. Un 4xx distinto no se reintenta.

OpenAPI 3.1