REST API Documentation¶
Moduli API¶
| Modulo | Base Path | Tech Stack | Porta | Auth |
|---|---|---|---|---|
| GecoService | /GecoService/rest |
JAX-RS/RESTEasy 3.6.1 | 8080 | Spring Security 3.2 |
| ConnessioneService | /ConnessioneService/rest |
JAX-RS/RESTEasy 4.7.7 | 8080 | WildFly Realm |
| ElaborazioneService | /ElaborazioneService/rest |
JAX-RS/RESTEasy 4.7.7 | 8080 | WildFly Realm |
| REST (Quarkus) | /api |
Quarkus 2.16.5/JAX-RS | 8082 | X-Realm header |
| MobileFineAdapter | /mobile/api |
Spring Boot 1.5.8/MVC | 8083 | BASIC auth |
Autenticazione¶
WildFly Modules (GecoService, ConnessioneService, ElaborazioneService)¶
Autenticazione tramite ApplicationRealm di WildFly. Le credenziali sono gestite a livello container.
REST (Quarkus) - Multi-Tenant¶
Ogni richiesta deve includere l'header X-Realm per identificare il tenant:
GET /api/verbale/ricerca HTTP/1.1
Host: localhost:8082
X-Realm: c_a662
Content-Type: application/json
MobileFineAdapter - BASIC Auth¶
Autenticazione HTTP BASIC con credenziali ApplicationRealm:
GET /mobile/api/tabelleFisse HTTP/1.1
Host: localhost:8083
Authorization: Basic dXNlcjpwYXNzd29yZA==
Endpoint per Modulo¶
ConnessioneService (/ConnessioneService/rest)¶
WebPortalService (/rest/WebPortalService)¶
| Metodo | Path | Descrizione |
|---|---|---|
POST |
/login |
Login con username, password, reparto, portale |
POST |
/ricercaVerbalePagamento |
Ricerca dati pagamento per numero/lettera/targa |
POST |
/ricercaVerbaleDati |
Ricerca dati verbale per numero/lettera/targa |
POST |
/consultaVerbaleAnonimo |
Consultazione anonima verbale tramite IUV/targa |
PndConnRestService (/rest/PndConnRestService)¶
Integrazione con il servizio PND (Punto di Notifica Digitale). Gestisce invio e tracking notifiche digitali.
InadConnRestService (/rest/InadConnRestService)¶
Integrazione con INAD (Indice Nazionale Domicili Digitali). Recupero domicili digitali PEC/PEO.
VisuraAnagraficaConnRestService (/rest/VisuraAnagraficaConnRestService)¶
Integrazione con ANPR (Anagrafe Nazionale). Visure anagrafiche per codice fiscale o dati anagrafici.
DocFlyService (/rest/DocFlyService)¶
Integrazione SOAP con DocFly per archiviazione e recupero documenti.
MailRestService (/rest/MailRestService)¶
Servizio invio email con template configurabili.
ElaborazioneService (/ElaborazioneService/rest)¶
VerbaliRestService (/rest/VerbaliRestService)¶
Elaborazione asincrona di verbali: generazione PDF, postalizzazione, batch processing.
VisuraAnagraficaElabRestService¶
Elaborazione dati anagrafici recuperati da ANPR.
UtilityService (/rest/UtilityService)¶
Metodi di utilita (conversioni, validazioni, calcoli scadenze).
VerbaleInsService (SOAP)¶
Web Service SOAP per inserimento verbali da sistemi esterni.
PdndService¶
Servizio integrazione PDND (Piattaforma Digitale Nazionale Dati).
REST - Quarkus (/api)¶
VerbaleResource (/verbale)¶
| Metodo | Path | Descrizione | Header |
|---|---|---|---|
POST |
/verbale/ricerca |
Ricerca verbali con filtri | X-Realm obbligatorio |
MobileFineAdapter (/mobile/api)¶
RestControllerCaricoTabelleFisse¶
Caricamento tabelle fisse (comuni, violazioni, tariffe) sui tablet degli agenti.
RestControllerScaricoTablet¶
Download dati dal tablet: verbali emessi su strada, foto, firme.
RestControllerIndaginiRealTime¶
Interrogazioni real-time durante accertamento su strada (visure targa, patente).