OpenAPI
Modello aziendale per capability: integrazioni semplici, regole dure.
Qualunque integrazione deve rispettare: precheck → proof → verify.
Regola: se non verificabile → INVALID (fail-closed).
UE-first · audit-first · fail-closed · hash-only · append-only · GDPR-min · no public data custody
Cos’è (in pratica)
API come contratto operativo
Le “API” qui non sono solo endpoint: sono un contratto di operatività verificabile. Prima di eseguire un’azione in un sistema (software, AI, robotica), l’identità operativa deve essere verificata.
IPR come chiave
IPR è un identificatore operativo: come codice fiscale / IBAN / numero documento, ma per operatività digitale. Serve a rendere attribuibili e opponibili nel tempo workflow e azioni.
Hash-only + append-only
Il portale pubblico pubblica prove minimizzate (hash-only) su un registry append-only. Nessuna custodia pubblica di dati personali.
Flusso minimo di integrazione (canonico)
Pattern “precheck-before-action” (UE)
1) Precheck
- leggi l’IPR/hash (input)
- verifica integrità (hash calcolato localmente)
- verifica match nel registry (VERIFY)
2) Action
- esegui solo se VALID
- registra evidenza minimizzata (proof)
- mantieni coerenza temporale
3) Proof
- hash, timestamp, reference
- evidenza verificabile da terze parti
- nessun dato personale pubblicato
Capacità (cosa integri davvero)
AI / Workflow
Attribuzione output AI e procedure ripetibili con evidenze verificabili.
Rete operatori
Emissioni e procedure in rete: operatori, nodi, coordinamento e governance.
Regole UE (minime)
- Non custodire dati personali pubblici: prove hash-only
- Append-only: nessuna retroattività nel registry
- Fail-closed: assenza di prova = blocco
- Audit-first: ogni claim deve essere verificabile
- Determinismo: stessi input → stesso risultato
Nota: questa pagina è “operativa” come specifica di integrazione, non come documentazione di endpoint REST. Endpoint formali verranno pubblicati quando il gateway sarà connesso al backend/servizi.
HERMETICUM - BLINDATA · COMPUTABILE · EVOLUTIVA
HERMETICUM B.C.E. S.r.l.