HIR Casa — PRECA Backend

Mapa de APIs

Con quién habla api1 y qué contrato usa cada relación. Clic en un nodo del diagrama, luego clic en un endpoint para ver su contrato completo.

Auth real, probada en vivo (10/sep): detrás de APIM hay una tercera capa de auth además de X-API-Key/token de proceso -- GET /healthz sin ningún header respondió 200 en api1-dev, pero 401 {"message":"Acceso denegado: Token invalido"} en api2-dev, api3-dev, api1-qa y api1-prod. Esa credencial vive en la configuración de APIM, no en este repo ni en el código de api1/api2/api3 -- y el frontend de PRECA (simple.html) tampoco la manda, aunque ya apunta a esas URLs. Detalle completo en la Guía de integración.
flowchart LR
  classDef ext fill:#3a2418,stroke:#f2731e,color:#fdece1
  classDef a1 fill:#1a1638,stroke:#1a1638,color:#fff
  classDef a2 fill:#4338ca,stroke:#4338ca,color:#fff
  classDef a3 fill:#4338ca,stroke:#4338ca,color:#fff
  classDef cli fill:#eef0fd,stroke:#4338ca,color:#1c1a2e

  EMB["Embajadores"]:::ext
  IA["Proveedor de IA"]:::ext
  BURO["Buró Facade
(BPR Casa)"]:::ext CLI["Cliente / Integrador
(hoy: frontend de PRECA)"]:::cli A1["api1
Hub"]:::a1 API2["api2
Motor de Política"]:::a2 API3["api3
Modelo ML"]:::a3 EMB -->|"1 · POST /embajadores/solicitud
sin auth, a propósito"| A1 A1 -->|"2 · analiza depósitos (async)"| IA CLI -->|"3 · GET /procesos/{id}
polling hasta que termine"| A1 CLI -->|"4 · POST /buro/consultar-api"| A1 A1 -->|"con token de proceso"| BURO CLI -->|"5 · POST /policy/evaluate
ingreso verificado + indicadores de Buró"| API2 CLI -->|"6 · POST /predecir/
solo si api2 devolvió segmento"| API3 CLI -->|"7 · POST /clasificacion/persistir
guarda resultado de api2 + api3"| A1

Vista general del orden real de llamadas (ejecutarOrquestacion() en simple.html) y qué depende de qué -- para el contrato completo de cada endpoint, incluidas Admin y las herramientas de Dev, elige una relación abajo.

🗺️ Selecciona una relación en el diagrama de arriba para ver sus endpoints.