Estás integrando la API pública de Telepatia Synapse.
Endpoint: GET /v1/scribe-sessions/{id}/medical-record-documents
Base URL: https://scribe-api.telepatia.ai
Auth: Authorization: Bearer ${SYNAPSE_API_KEY}
Solicitud:
- id [path]: string (requerido, pattern=^[a-zA-Z0-9_-]+$, minLength=1, maxLength=128) — La sesión a buscar — su consultationInternalId, o el id de la sesión (ss_...) que la API devuelve.
- purpose [query]: string (opcional, minLength=1, maxLength=255) — Optional filter — return only documents with this purpose. Use 'report' to get only the dictated reports.
Éxito 200:
- items: array<MedicalRecordDocumentItem>
- total: integer
Errores (envoltorio: { error: { type, code, message, param? } }):
- 400: parameter_missing, parameter_invalid, account_invalid
- 401: authentication_required
- 403: permission_denied, permission_denied_role
- 404: resource_not_found
- 503: service_unavailable
Genera código en el lenguaje del archivo actual que:
1. Lea SYNAPSE_API_KEY desde el entorno (no lo escribas de forma fija).
2. Llame al endpoint con solicitud y respuesta tipadas.
3. Asigne el envoltorio de errores a excepciones tipadas por código de estado.
4. Agregue una prueba de flujo exitoso usando el token Bearer.
