GEMODO DEV - API GEBAN

Documentazione e test manuale delle API catalogo, contratto dati e validazione payload.

SSO richiesto

Accesso SSO CNR richiesto

Questa pagina DEV mostra documentazione e link operativi solo dopo login SSO tramite client pubblico gemodo-frontend. Il token resta nel browser per la sessione corrente.

Sessione

Utente autenticato.

Documentazione

Swagger catalogo GEBAN Console interattiva del contratto OpenAPI versionato. Usa Authorize per login SSO con gemodo-frontend.
ReDoc catalogo GEBAN Stesso contratto di Swagger, ma impaginato come documentazione leggibile per integratori.
OpenAPI YAML Sorgente tecnica del contratto API, utile per client automatici e import in Postman.
Swagger runtime FastAPI Schema generato dal backend in esecuzione. Serve a confrontare runtime e contratto versionato.

Autenticazione Swagger

Swagger usa login SSO con client pubblico gemodo-frontend. Per chiamare le API, il token dell'utente deve avere audience gemodo-backend e ruoli client su gemodo-backend.
1. Apri Swagger Vai su /docs/geban-catalog.
2. Premi Authorize Seleziona OAuth2/SSO e completa il login CNR.
3. Esegui le chiamate Prova prima classificazione, poi modelli filtrando per tipologia e profilo, quindi campi e validazione.

Configurazione Keycloak richiesta: redirect URI del client gemodo-frontend verso https://dev-gemodo.concorsi.cnr.it/*, web origin dello stesso dominio, audience mapper verso gemodo-backend, e ruoli DOCUMENTI_VIEWER/DOCUMENTI_GENERATORE assegnati all'utente sul client gemodo-backend.

API disponibili ora

GET
/api/v1/catalogo/tipi-documento
Elenca i tipi documento disponibili.
DOCUMENTI_VIEWER
GET
/api/v1/catalogo/tipi-documento/{codice}/profili
Elenca i profili attivi per un tipo documento.
DOCUMENTI_VIEWER
GET
/api/v1/catalogo/tipi-documento/{codice}/classificazione
Restituisce l'albero tipologie/procedure SOL -> profili; il codice SOL resta interno.
DOCUMENTI_VIEWER
GET
/api/v1/catalogo/modelli?tipo_documento=BANDO_CONCORSO&codice_tipologia=TD&profilo=CTER
Restituisce versioni modello pubblicate e valide per il nodo dell'albero scelto. Ogni combinazione della classificazione bandi ha un modello demo temporaneo.
DOCUMENTI_VIEWER
GET
/api/v1/catalogo/modelli/{id}/campi-richiesti
Restituisce il contratto dati del modello selezionato.
DOCUMENTI_VIEWER
POST
/api/v1/documenti/valida
Valida il payload GEBAN prima della generazione documentale.
DOCUMENTI_GENERATORE
POST
/api/v1/documenti/genera
Simula la generazione: valida i dati e restituisce un OK con placeholder del futuro link PDF.
DOCUMENTI_GENERATORE

Nota PDF

La generazione PDF reale non è ancora implementata nel backend attuale. L'endpoint /api/v1/documenti/genera è uno stub di collaudo: controlla token e dati, poi risponde con il testo che indica dove sarà restituito il link di download.