# JC2.1 - Dal browser al servizio giusto

**In una frase.** Come fa una richiesta partita dalla tua pagina ad arrivare proprio al servizio che la sa soddisfare, e a tornare con la risposta.

Ogni volta che apri una tabella, premi **Salva** o chiedi una stampa, la pagina manda una richiesta. Le richieste sono tante e i servizi sono diversi. Il Gateway le smista tutte con una regola sola, semplice da controllare: guarda come comincia l'indirizzo.

<div drawio-diagram="2654"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/il-viaggio-di-una-richiesta-dalla-pagina-al-gateway-al-servizio-e-ritorno.png" alt="Il viaggio di una richiesta: dalla pagina al Gateway, al servizio, e ritorno"/></div>

*Il viaggio di una richiesta: dalla pagina al Gateway, al servizio, e ritorno*

Il viaggio, in ordine.

**La pagina chiede.** La richiesta parte dal browser e porta con sé il tuo lasciapassare, cioè la prova che sei entrato.

**Il Gateway controlla.** Se il lasciapassare manca o non è valido, il viaggio finisce qui. Come lo controlla è in [Come si controlla chi sei](https://gsdoc.genesyssoftware.eu/link/37802).

**Il Gateway legge l'inizio dell'indirizzo.** Ogni servizio ha il suo:

<table id="bkmrk-l%27indirizzo-comincia"><thead><tr><th>L'indirizzo comincia con</th><th>La richiesta va a</th><th>Per fare cosa</th></tr></thead><tbody><tr><td>`/api/ade`</td><td>ADEnext</td><td>Schermate disegnate, cruscotti di Analytics</td></tr><tr><td>`/api/sigea`</td><td>SIGEAnext</td><td>Dati del gestionale</td></tr><tr><td>`/api/gpe`</td><td>GPEnext</td><td>Stampe e modelli</td></tr><tr><td>`/api/sigeagent`</td><td>Assistente dei dati</td><td>Domande sui dati (solo dove è acceso)</td></tr></tbody></table>

**Chiede al Monitor servizi dove sta quel servizio.** Il Gateway conosce il nome del servizio, non il suo indirizzo. L'indirizzo lo prende dall'elenco.

**Inoltra.** Toglie dall'indirizzo il pezzo iniziale, che serviva solo a lui, scrive sulla richiesta il tuo nome utente e la consegna.

**La risposta torna dalla stessa strada.** Il servizio risponde al Gateway, il Gateway alla pagina.

<p class="callout info">**Per chi sviluppa.**  
• Le rotte sono in `backend/middleware/it_gsba_api_gateway/src/main/java/it/gsba/api_gateway/config/GatewayConfig.java`. Ognuna ha `stripPrefix(2)` e il filtro `AuthenticationFilter`.  
• La destinazione è `lb://NOME-DEL-SERVIZIO`: il nome con cui il servizio si è iscritto al Monitor servizi.  
• L'Assistente dei dati fa eccezione: ha un indirizzo fisso e la sua rotta esiste solo con `SIGEAGENT_ENABLED=true`.  
• Davanti al Gateway c'è il server web dell'app (`frontend/docker/nginx.conf`), che gli passa tutto ciò che comincia per `/api/`. Le richieste lunghe possono durare fino a dieci minuti. </p>