Estás integrando la API pública de Telepatia Synapse.
Endpoint: GET /v1/institutional/branches
Base URL: https://scribe-api.telepatia.ai
Auth: Authorization: Bearer ${SYNAPSE_API_KEY}
Clave: solo clave API institucional. Una clave API de médico recibe 403 permission_denied.
Solicitud:
- page [query]: integer (opcional, min=1)
- limit [query]: integer (opcional, min=1, max=100)
Éxito 200:
- items: array<BranchSummary>
- total: integer
- page: integer
- limit: 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.
