API Doctor
Usa la API Doctor cuando integras para una cuenta de médico que ya existe. Telepatia, o tu propia integración institucional, creó la cuenta y te entregó su clave secreta. El flujo es un único ciclo de consulta:- Define el contexto de la consulta: datos del paciente más un Smart Template.
- Abre el scribe para el médico (o transmite una sesión en vivo).
- Obtén los resultados: la sesión de scribe y el documento de historia clínica.
API Institucional
Usa la API Institucional cuando tu plataforma aprovisiona y gestiona a muchos médicos por sí misma. Es un superconjunto de la API Doctor: agrega una capa de gestión, y cada médico sigue ejecutando el flujo Doctor descrito arriba. El flujo tiene primero un paso de aprovisionamiento y luego el mismo ciclo de consulta por médico:- Aprovisiona la institución: crea cuentas de médico y sedes. Cada cuenta devuelve su propia clave secreta de médico.
- Configura los controles de la institución: webhooks y auditorías, autenticados con la clave institucional.
- Ejecuta cada consulta: con la clave de ese médico, sigue el flujo Doctor descrito arriba.
¿Cuál uso?
Cada endpoint de la API Doctor también está disponible con la clave institucional. La
API Institucional solo agrega la gestión de cuentas, sedes, webhooks y
auditorías sobre el mismo flujo de consulta.