Saltar al contenido principal
Una auditoría califica la historia clínica de una sesión de scribe finalizada frente a una rúbrica (una configuración de auditoría). Devuelve un total ponderado en una escala de 0 a 1, una calificación cualitativa y un desglose por secciones.
El acceso de lectura a las auditorías depende del rol de tu API key. La auditoría de una sesión está disponible para una clave de médico (sus propias sesiones) y para una clave institucional. La lista de auditorías y las configuraciones requieren una clave institucional.

Consultar la auditoría de una sesión

GET /v1/scribe-sessions/{id}/audit devuelve la auditoría de una sesión. El {id} es el consultationInternalId que definiste, o el id de la sesión (ss_...) que devuelve la API. Devuelve 404 cuando la sesión no tiene auditoría: la auditoría está deshabilitada para esa sesión o aún no se ha ejecutado.
Respuesta:
score es el total ponderado en una escala de 0 a 1. Asócialo a una banda de calificación con los scoreBands de la rúbrica, que se describen más abajo en la sección de configuraciones de auditoría.

Listar auditorías

GET /v1/audits lista las auditorías de tu institución, de la más reciente a la más antigua. Requiere una API key institucional; con una clave de médico devuelve 403. Pagina con page (base 1) y limit (1–50, por defecto 20). Filtra con reviewStatus, createdFrom y createdTo.
Respuesta:
total y totalPages son siempre null: el servidor no cuenta los elementos de la lista. Usa hasMore para paginar. Cada elemento omite el desglose por secciones; obtén la auditoría completa desde el endpoint de la sesión descrito arriba.

Configuraciones de auditoría

GET /v1/audits/configurations devuelve las rúbricas asignadas a tu institución, es decir, las que se usan para auditarla. Requiere una API key institucional. Cada rúbrica lista sus sections ponderadas y sus scoreBands de calificación, para que puedas convertir un score en una etiqueta.
Respuesta:
A un puntaje le corresponde la primera banda cuyo threshold sea igual o menor que él (las bandas están ordenadas por threshold de forma descendente). label y displayName pueden ser null cuando la rúbrica no tiene texto en el idioma predeterminado.