https://genie-ai-7e342b.opensource.unicc.org/docs/backend/Recent content in Backend (Gov-Chat API) on GENIE.AIHugoenhttps://genie-ai-7e342b.opensource.unicc.org/docs/backend/api-contracts-backend/Mon, 01 Jan 0001 00:00:00 +0000https://genie-ai-7e342b.opensource.unicc.org/docs/backend/api-contracts-backend/<blockquote> <p><strong>For integrators.</strong> The backend (BFF) HTTP API contracts — request/response shapes for auth, chat, files, analytics, and admin endpoints.</p> </blockquote> <p><strong>Component</strong>: <code>components/gov-chat-backend/</code> (Node.js/Express) <strong>Base URL</strong>: <code>https://&lt;domain&gt;/api</code> (via Kong Gateway) <strong>Documentation</strong>: Swagger/OpenAPI available at <code>/api-docs</code></p> <h2 id="authentication">Authentication</h2> <p>All endpoints (except where noted) require Keycloak JWT authentication via <code>Authorization: Bearer &lt;token&gt;</code> header.</p> <p><strong>Auth middleware</strong>: <code>keycloakAuthMiddleware.authenticate</code> (Keycloak OIDC) <strong>Admin endpoints</strong>: Additional <code>keycloakAuthMiddleware.requireAdmin</code> middleware</p> <hr> <h2 id="route-domains">Route Domains</h2> <h3 id="1-authentication-routes-apiauth">1. Authentication Routes (<code>/api/auth</code>)</h3> <p><strong>Route File</strong>: <code>routes/auth-routes.js</code> <strong>Auth Required</strong>: None (login/logout endpoints) <strong>Base Paths</strong>: <code>/api/auth</code></p>