Interoperability & AgID model

CAD/AgID interoperability model, REST and OpenAPI 3 profile; scope and contractual limits.

Ultimo aggiornamento: maggio 2026
Versione documento: 2026.05

Scopo

Questa pagina descrive a cosa Flowvenue fa riferimento quando dichiara l’allineamento alle buone pratiche di interoperabilità per le API REST del servizio cloud, nel contesto del Modello di interoperabilità promosso dall’Agenzia per l’Italia Digitale (AgID) e della normativa italiana in materia di amministrazione digitale.

Non costituisce consulenza legale e non sostituisce eventuali allegati contrattuali, DPA o attestazioni firmate richiesti dal singolo committente (in particolare dalla Pubblica Amministrazione).

Riferimenti normativi e istituzionali (quadro)

Flowvenue colloca le proprie API REST interoperabili nel quadro generale della digitalizzazione della PA e dei soggetti privati che interoperano con essa, facendo riferimento a:

Elemento Descrizione sintetica
Codice dell’amministrazione digitale (CAD) Decreto legislativo 14 marzo 2005, n. 82 e successive modifiche e integrazioni, quale corpus normativo di riferimento in Italia per l’amministrazione digitale e i correlati obblighi di cooperazione applicativa.
Modello di interoperabilità Il modello definito e aggiornato da AgID per favorire l’interoperabilità tra sistemi informativi, nel rispetto delle disposizioni applicabili. La versione corrente di circolari, linee guida e materiali tecnici è pubblicata da AgID e dagli organismi competenti e va verificata sul sito istituzionale al momento della due diligence.
Linee guida e profili tecnici Documentazione tecnica e profili di interoperabilità pubblicati da AgID (e collegati al modello), inclusi gli orientamenti per la descrizione machine-readable delle interfacce applicative (es. OpenAPI 3 per servizi REST), così come aggiornati nel tempo.

Link di riferimento (esterno, soggetto a mutamento da parte dell’editore):

Per il Modello di interoperabilità e i relativi allegati tecnici aggiornati, AgID e i portali collegati pubblicano materiali in evoluzione: si raccomanda di verificare sempre le sezioni dedicate sui siti ufficiali al momento della due diligence (percorsi e URL profondi possono cambiare nel tempo).

Profilo tecnico adottato da Flowvenue per le API REST

Per le interfacce applicative REST esposte dal servizio cloud Flowvenue che rientrano nel perimetro documentato (catalogo mount e, dove pubblicato, OpenAPI 3), adottiamo il seguente profilo tecnico di descrizione:

Voce Scelta / nota
Stile di integrazione HTTP/REST (JSON), TLS in produzione.
Specifica machine-readable OpenAPI 3.x (YAML/JSON), per supportare integrazioni, assessment fornitore e pianificazione tecnica.
Ambito della documentazione OpenAPI Catalogo interno dei mount e sottoinsieme di operazioni documentate in dettaglio (inclusa la famiglia Inbound API /api/inbound/v1 dove applicabile). L’esaustività operazione-per-operazione può essere estesa su richiesta e/o in sede contrattuale.
SOAP / WSDL Non utilizzati per le API REST descritte in questa sezione.

Il file OpenAPI di catalogo interno e le relative note sono descritti nella Panoramica compliance (voce REST API catalog & OpenAPI) e resi disponibili agli account Super User autenticati come indicato in quella pagina.

Limiti e chiarezza per il committente

Contatti

Per chiarimenti su questa dichiarazione tecnica e sul perimetro delle API:

Attestazioni aggiuntive richieste da capitolati PA si contrattualizzano per iscritto con il committente ove non coperte da questa pagina informativa.

Nota: documentazione pubblica. Per evidenze contrattuali o allegati firmati, utilizzare i canali indicati in Verifica & Evidenze.