Skip to main content
La Scribe API tiene dos superficies de integración. Comparten el mismo flujo central de consulta — definir un contexto, ejecutar el scribe, obtener el registro. Se diferencian en quién aprovisiona las cuentas de médico y en la clave con la que se autentica.

​
API Doctor

Use la API Doctor cuando integra para una cuenta de médico que ya existe. Telepatia, o su propia integración institucional, creó la cuenta y le entregó su clave secreta. El flujo es un único ciclo de consulta:
  1. Defina el contexto de la consulta — datos del paciente y una Smart Template.
  2. Inicie el scribe para el clínico (o transmita una sesión en vivo).
  3. Obtenga los resultados — la sesión de scribe y el documento de registro médico.
La API Doctor no crea cuentas, sucursales ni webhooks.

​
API Institucional

Use la API Institucional cuando su 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 anterior. El flujo tiene primero un paso de aprovisionamiento, y luego el mismo ciclo de consulta por médico:
  1. Aprovisione la institución — cree cuentas de médico y sucursales. Cada cuenta devuelve su propia clave secreta de médico.
  2. Configure los controles de la institución — webhooks y auditorías, autenticados con la clave institucional.
  3. Ejecute cada consulta — con la clave de ese médico, siga el flujo Doctor anterior.

​
¿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, sucursales, webhooks y auditorías sobre el mismo flujo de consulta.
Siguiente: Autenticación explica los tipos de clave, y el Inicio rápido recorre el flujo de consulta de principio a fin.