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.