Saltar al contenido
FibonacciOdontologíaAccedePrueba gratis

Para desarrolladores

Conecta tu programa a Fibonacci

Las API están abiertas, en FHIR R4 con OAuth 2.0. El estudio decide qué puede leer tu programa y puede quitarle el acceso cuando quiera.

La pantalla de un portátil con código de colores.
La marca de Fibonacci para la medicina estética: una carpeta blanca con la espiral áurea sobre un cuadrado azul.
Accesos para programas externosPermisos estrictos, decididos por la consultaFHIR R4, ningún dato clínico

Autenticación

Cómo se entra: dos modos

Clave del consultorio

Quién puede usarla: un consultorio, para un programa suyo o de un proveedor que trabaja para él. La crea quien administra el consultorio, y la función se activa a petición.

Tres permisos, que se suman: agenda en solo lectura, solicitudes de cita y datos de contacto de los pacientes.

El secreto se ve una sola vez y el token dura una hora.

curl -s -X POST "https://app.fibonaccimedica.it/api/oauth2/token" \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode "client_id=$CLIENT_ID" \
  --data-urlencode "client_secret=$CLIENT_SECRET"

App registrada, con el consentimiento del consultorio En camino

Quién puede usarla: una empresa que hace un producto para muchos consultorios. La registramos nosotros, una por una, y cada consultorio la conecta con un clic.

Cinco permisos cerrados: agenda en lectura y escritura, solicitudes de cita, datos de contacto y facturas en lectura sin las líneas.

Ningún secreto compartido: el JWT se firma con tu clave privada y dura como máximo cinco minutos.

curl -X POST "$TOKEN_URL" \
  -d grant_type=client_credentials \
  -d client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer \
  -d client_assertion="$JWT"

Datos clínicos, ninguno. Anamnesis, visitas, tratamientos, fotos, consentimientos y facturas quedan fuera, elija la clínica el permiso que elija: pedirlos da 403.

Guía rápida

Cinco pasos para la primera llamada

  1. Nos escribes qué hace tu programa

    Desde la página Partner, con los permisos que necesitas.

  2. El consultorio activa el acceso

    Quien lo administra crea una clave, o conecta tu app registrada.

  3. Pide el token

    Dura una hora: pídelo una vez y reutilízalo.

  4. Llamas a las API FHIR R4

    Solo en las direcciones del estudio que te ha dado el acceso.

  5. Recibes las notificaciones

    Un mensaje firmado cuando una cita nace, cambia o se cancela.

Ejemplos

Leer los horarios libres y recibir las notificaciones

La guía técnica completa, con todas las respuestas y los errores, se la enviamos a quien haya designado la consulta.

Leer los horarios libres

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://app.fibonaccimedica.it/api/fhir/R4/Slot?schedule=Schedule/$AGENDA&status=free&_sort=start"

La notificación que llega a tu programa

POST /notifiche HTTP/1.1
Content-Type: application/json; charset=utf-8
X-Fibonacci-Firma: t=1781342400,v1=9f2c…

{
  "evento": "appuntamento.creato",
  "appuntamento": { "stato": "booked", "inizio": "2026-11-20T09:00:00Z" },
  "riferimenti": { "paziente": "Patient/…", "operatore": "Practitioner/…" }
}

La cabecera X-Fibonacci-Firma lleva la hora y la firma del cuerpo: la verificas con el secreto que la consulta ve una sola vez.

Sin escribir código: Zapier, Make, n8n y MCP usan los mismos accesos, con las mismas claves. Las integraciones de hoy

Preguntas frecuentes

Las preguntas de quien escribe la integración

¿Qué estándares usáis?

FHIR R4 para los datos y OAuth 2.0 con client credentials para el acceso. Las notificaciones son JSON firmados.

¿Puedo buscar pacientes por apellido?

No. Las listas de pacientes y citas no se pueden buscar: una búsqueda por apellido revelaría el apellido de todos modos. Los códigos te llegan con las notificaciones o desde los horarios.

¿Qué pasa si la consulta revoca la clave?

El token que tienes deja de funcionar de inmediato, no al vencer, y ya no se puede pedir uno nuevo.

¿Hay límites de solicitudes?

Sí. El token dura una hora: pídelo una vez y reutilízalo. Por encima del límite, la dirección del token responde 429.

¿Hace falta un contrato con la consulta?

Por norma, sí: un programa que trata estos datos por cuenta de la consulta es un encargado del tratamiento, y hace falta el acuerdo del artículo 28 del GDPR entre tú y la consulta.

¿Quieres conectar tu producto a Fibonacci?

Escríbenos qué hace y qué datos necesita. La integración la diseñamos juntos.