Digitální veřejná infrastruktura: architektura a stavební blok
Jak veřejné digitální infrastruktury proměňují vládní služby v globálním měřítku: od India Stack k eIDAS 2.0, od X-Road ke GovStack, komplexní technické analýze architektonických vzorů, stavebních bloků a rozhraní API, které umožňují digitální veřejnou infrastrukturu.
Co je digitální veřejná infrastruktura
La Digitální veřejná infrastruktura (DPI) představuje změnu paradigmatu v designu vládních digitálních služeb. Namísto budování monolitických řešení pro každou jednotlivou veřejnou službu zahrnuje přístup DPI vytvoření sdílené, modulární a interoperabilní stavební bloky kterou může jakákoli služba – veřejná nebo soukromá opětovné použití. Nejúčinnější je analogie s fyzickou infrastrukturou: stejně jako silnice a elektrické sítě a akvadukty jsou sdílené platformy, na kterých jsou postaveny různé služby, DPI poskytuje „digitální kolejnice“, na kterých běží ověřené identity, okamžité platby a bezpečná výměna dat.
Minimálně v roce 2025 64 zemí mají systémy digitální identity typu DPI, 97 zemí mají e. interoperabilní digitální platební systémy 103 zemí mají strukturované rámce pro výměnu dat. OOP není spíše teoretický koncept: jde o provozní infrastrukturu, která se dotýká miliard lidí.
Formální definice OOP
Podle UNDP a G20 je digitální veřejná infrastruktura definována jako soubor sdílené, otevřené a interoperabilní technologické platformy které umožňují poskytování služeb digitální v celostátním měřítku. Komponenty DPI jsou navrženy jako softwarový kód, platformy, aplikace a rozhraní API jsou svou povahou modulární a lze je kombinovat a vytvořit tak kompletní technologický balík.
Proč se DPI liší od tradičního e-Governmentu
Tradiční e-Government vytvořil sila: každé ministerstvo buduje svůj vlastní systém s vlastní databází uživatelů, svůj vlastní ověřovací mechanismus, vlastní platební bránu. Výsledkem je duplicita, nekompatibilita a exponenciální náklady. DPI převrací tuto logiku: jednou postavte základní bloky a celý ekosystém znovu je používá.
| čekám | Tradiční e-Government | Přístup OOP |
|---|---|---|
| Architektura | Monolitický, pro servis | Modulární, stavební blok |
| Identita | Oddělené databáze podle institucí | Vrstva sdílené identity |
| Platby | Proprietární brány | Interoperabilní platební železnice |
| Data | Výměna z bodu do bodu | Standardizovaná vrstva výměny dat |
| Mezní náklady | Vysoká (každá porce od nuly) | Nízká (opětovné použití stavebních bloků) |
| Čas na trh | let | Týdny/měsíce |
| Uzamčení dodavatele | Vysoký | Snížené (otevřené standardy) |
Tři základní pilíře OOP
Každá implementace DPI je postavena na tři vzájemně propojené pilíře které dohromady vytvářejí ekosystém plně digitální. Tyto pilíře nejsou nezávislé: jejich síla vychází ze synergie.
1. Digitální identita (Digital Identity)
Prvním pilířem je schopnost jednoznačně ověřit vaši identitu každého občana, společnosti nebo zařízení v ekosystému. Bez robustního systému digitální identity se žádná jiná služba neobejde provozovat bezpečně. Digitální identita DPI musí být: univerzální (pokrývat celou populaci), ověřitelné (s kryptografickými důkazy), minimální (sdílet pouze nezbytná data) a interoperabilní (práce napříč různé orgány a služby).
2. Digitální platby
Druhý pilíř to umožňuje směna ekonomické hodnoty v reálném čase mezi jakoukoli dvojicí herců v ekosystému. DPI platební lišta není jen brána: je to otevřená infrastruktura, která umožňuje jakékoli bance, fintech nebo instituci odesílat a přijímat okamžité platby prostřednictvím standardizovaných rozhraní API. Referenčním modelem je UPI v Indii, který v lednu 2026 šel před soud 21,7 miliardy transakcí v hodnotě více než 28 330 miliard rupií.
3. Výměna dat
Třetí pilíř zajišťuje a bezpečná a standardizovaná vrstva pro výměnu informací mezi různými systémy, v souladu se souhlasem uživatele a předpisy o ochraně osobních údajů. Rámec pro výměnu dat DPI zajišťuje, že data tok tam, kde jsou potřeba, když jsou potřeba, s kompletní sledovatelností a end-to-end šifrováním.
Synergie tří pilířů
Když občan žádá o státní dotaci, tři pilíře spolupracují:digitální identita ověřit, kdo je žadatelem, výměna dat získat potřebné údaje (příjem, bydliště, rodinný stav) z různých zdrojů, aniž by občan musel předkládat papírové dokumenty, a digitální platba poskytuje dotaci přímo na váš běžný účet v reálném čase. To, co tradičně vyžadovalo týdny byrokracie, je dokončeno v sekundách.
India Stack: Globální referenční model
L’Indie Stack je to nejvyspělejší a nejstudovanější případ OOP na světě. Zahajováno postupně od roku 2009, představuje ekosystém digitální infrastruktury, který slouží dál 1,4 miliardy lidí. Jeho úspěch má inspiroval G20, OSN a desítky zemí k replikaci modelu. V roce 2025 Indie vyvezla technologii UPI ve více než 25 zemích.
Aadhaar: Biometrická identita v národním měřítku
Aadhaar je to největší světový systém digitální identity s více než 1,3 miliardami registrací. Každý obyvatel obdrží jedinečné 12místné číslo spojené s jeho biometrickými údaji (otisky prstů a sken duhovky). Architektura Aadhaar je založena na principech zabezpečení podle návrhu: Biometrické protokoly byly integrovány v infrastruktuře od koncepce, později nepřidané.
Ověřovací rozhraní API Aadhaar odhaluje koncový bod ověřování, který podporuje tři režimy:
# Aadhaar Authentication API - Flusso di Verifica
# 1. Demographic Authentication
POST /api/v2/auth/demographic
Content-Type: application/xml
{
"aadhaar_number": "XXXX-XXXX-XXXX",
"name": "...",
"dob": "YYYY-MM-DD",
"gender": "M|F|T",
"address": {
"house": "...",
"street": "...",
"pincode": "XXXXXX"
}
}
# 2. Biometric Authentication (Fingerprint/Iris)
POST /api/v2/auth/biometric
{
"aadhaar_number": "XXXX-XXXX-XXXX",
"biometric_data": {
"type": "FIR|IIR", # Fingerprint / Iris
"position": "LEFT_INDEX",
"data": "<base64_encoded_biometric>"
},
"device_info": {
"device_id": "...",
"rdsv": "...", # Registered Device Service version
"mi": "...", # Model Info
"mc": "..." # Machine Code (signed)
}
}
# 3. OTP-based Authentication
POST /api/v2/auth/otp/generate
{ "aadhaar_number": "XXXX-XXXX-XXXX" }
POST /api/v2/auth/otp/verify
{
"aadhaar_number": "XXXX-XXXX-XXXX",
"otp": "XXXXXX",
"txn_id": "..."
}
# Response (comune a tutti i metodi)
{
"status": "Y|N",
"auth_token": "...",
"txn_id": "...",
"err_code": null,
"info": {
"auth_type": "DEMO|BIO|OTP",
"timestamp": "2026-03-09T10:30:00Z"
}
}UPI: Interoperabilní okamžité platby
Il Unified Payments Interface (UPI) je kolejnice pro platby v reálném čase vyvinutá společností NPCI (National Payments Corporation of India). Architektura UPI je založena na a centrální vypínač která propojuje všechny banky a poskytovatele platebních služeb (PSP) v zemi, což umožňuje okamžité převody z banky do banky, 24 hodin denně, 7 dní v týdnu, zdarma.
Vrstvená architektura UPI zahrnuje:
- Vrstvy aplikací: uživatelské aplikace (Google Pay, PhonePe, Paytm, BHIM)
- Vrstva PSP: Poskytovatelé platebních služeb, kteří spravují transakce jménem bank
- Přepínače NPCI: srdce infrastruktury, která směruje transakce mezi různými bankami
- Bankovní systémy: hlavní bankovnictví zúčastněných bank
- Autentizační vrstva: vazba zařízení, šifrovaný PIN a vícefaktorové ověření
- Vrstva osídlení: mezibankovní vypořádání ve více denních cyklech
# Architettura UPI - Flusso di una Transazione
# 1. L'utente inizia il pagamento dall'app
# 2. La richiesta arriva al PSP (Payment Service Provider)
# 3. Il PSP inoltra al NPCI Central Switch
# 4. Il switch identifica la banca destinataria
# 5. La banca destinataria conferma la disponibilità fondi
# 6. Il switch completa la transazione e notifica entrambe le parti
# Flusso tecnico semplificato:
[Payer App] --> [Payer PSP] --> [NPCI UPI Switch] --> [Payee PSP] --> [Payee Bank]
^ | |
| v v
| [Transaction Log] [Credit Account]
| |
+--------- [Response: Success/Failure] <--------+
# API di Collect Request (esempio semplificato)
POST /upi/v2/collect
{
"payer_vpa": "user@bankpsp",
"payee_vpa": "merchant@bankpsp",
"amount": {
"value": "500.00",
"currency": "INR"
},
"txn_note": "Payment for order #12345",
"txn_id": "TXN202603091030ABC",
"device_fingerprint": "...",
"encrypted_pin": "<encrypted_upi_pin>"
}
# Response
{
"status": "SUCCESS",
"txn_id": "TXN202603091030ABC",
"rrn": "631012345678", # Retrieval Reference Number
"approval_number": "ABC123",
"timestamp": "2026-03-09T10:30:05Z",
"payer_vpa": "user@bankpsp",
"payee_vpa": "merchant@bankpsp",
"amount": "500.00"
}DigiLocker a ONDC: Výměna dat a otevřený obchod
DigiLocker je platforma pro výměnu dokumentů, která umožňuje indickým občanům archivovat a sdílet úřední dokumenty (řidičský průkaz, školní vysvědčení, zdravotní průkaz) v ověřitelném digitálním formátu. Architektura je založena na modelu sdílení na základě souhlasu: dokument se nikdy nezkopíruje, ale je poskytnut ověřitelný odkaz na originál s dočasnou platností kontrolovanou vlastníkem.
L’Otevřená síť pro digitální obchod (ONDC) rozšiřuje paradigma DPI na e-commerce a vytváří a otevřený protokol, který odděluje vyhledávací/objevovací platformy od prodejců a logistických služeb, čímž eliminuje monopol velkých uzavřených plošin.
Skutečný dopad Indie Stack
- Aadhaar: 1,3+ miliard registrací, 100+ miliard provedených autentizací
- UPI: 21,7 miliardy transakcí/měsíc (leden 2026), exportováno do 25+ zemí
- DigiLocker: 200+ milionů uživatelů, 6+ miliard vydaných dokumentů
- Úspory: více než 33 miliard USD ušetřeno přímými převody (eliminace zprostředkovatelů)
- Zařazení: 500+ milionů bankovních účtů otevřených prostřednictvím Jan Dhan Yojana + Aadhaar
Evropský přístup: eIDAS 2.0 a EUDI Wallet
Evropa buduje svá vlastní práva duševního vlastnictví s odlišným přístupem než Indie: odkud se zrodil India Stack evropský přístup vychází z potřeby finančního začlenění v zemi s omezenou infrastrukturou ochrana základních práv, soukromí již od návrhu a digitální suverenita. The Nařízení eIDAS 2.0 (Nařízení EU 2024/1183) je legislativním pilířem, díky kterému je povinná pro všechny Členské státy poskytují svým občanům peněženku digitální identity prosince 2026.
EUDI Wallet: Architektura a principy
L’Peněženka EU Digital Identity Wallet (EUDI) je navržena podle zásadně jiných principů než centralizované systémy:
- Místní úložiště: data jsou uložena na zařízení uživatele, nikoli na centrálních serverech
- Uživatelské ovládání: uživatel se rozhodne, jaké informace s kým sdílet
- Nulové sledování: design zajišťuje, že žádný herec nemůže profilovat uživatele
- Panel ochrany osobních údajů: Úplná transparentnost ohledně toho, jak a s kým jsou informace sdíleny
- Uvolnit: bezplatné vydání, použití a odvolání pro všechny fyzické osoby
# EUDI Wallet - Architettura Semplificata
# Componenti principali:
[Citizen Device]
|
+-- [EUDI Wallet App]
| |
| +-- [Credential Store] # PID, attestazioni, certificati
| +-- [Crypto Engine] # Chiavi private, firma digitale
| +-- [Privacy Dashboard] # Log condivisioni, revoche
| +-- [Consent Manager] # Gestione consensi granulari
|
+-- [Secure Element / TEE] # Hardware-backed key storage
# Flusso di Verifiable Presentation
# 1. Il Relying Party richiede attributi specifici
# 2. Il Wallet mostra all'utente cosa viene richiesto
# 3. L'utente approva/nega selettivamente
# 4. Il Wallet crea una Verifiable Presentation firmata
# 5. Il Relying Party verifica la firma e la validita
# Esempio: Verifica eta senza rivelare la data di nascita
POST /wallet/v1/presentation
{
"verifier_id": "bar-nightclub-001",
"requested_claims": ["age_over_18"],
"purpose": "Age verification for entry",
"nonce": "abc123xyz",
"response_uri": "https://verifier.example.com/callback"
}
# Wallet Response (selective disclosure)
{
"vp_token": "<signed_verifiable_presentation>",
"presentation_submission": {
"descriptor_map": [
{
"id": "age_over_18",
"format": "mso_mdoc",
"path": "$.credentials[0]"
}
]
},
"disclosed_claims": {
"age_over_18": true
# NOTA: la data di nascita NON viene condivisa
}
}Časová osa implementace eIDAS 2.0
| Datum | Milníky | Detail |
|---|---|---|
| května 2024 | Předpis schválen | Nařízení EU 2024/1183 zveřejněné v Úředním věstníku |
| prosince 2024 | První soubor prováděcích aktů | Technické specifikace pro datové formáty a přeshraniční interoperabilitu |
| července 2025 | Kompletní prováděcí dokumenty | Normy pro bezpečnost, spolehlivost a technickou funkčnost peněženek |
| prosince 2026 | Peněženky k dispozici | Každý členský stát musí svým občanům zpřístupnit peněženku EUDI |
| prosince 2027 | Povinné přijetí | Povinné přijetí regulovanými soukromými sektory a VLOP |
EBSI: Evropská infrastruktura blockchainových služeb
L’EBSI přidává další vrstvu do evropské architektury DPI: povolený blockchain, který poskytuje služby ověřitelné pověření, notářské ověření, sledovatelnost a časové razítko sdílené mezi všemi členské státy. EBSI není náhradou za tradiční systémy, ale doplňkem, který přidává záruky neměnnost a kryptografická ověřitelnost vůči přeshraničním procesům.
GovStack: Standard stavebního bloku
GovStack je mezinárodní iniciativa vedená ITU, GIZ, Estonskem a DIAL, která definuje otevřené technické specifikace pro stavební bloky vládních digitálních služeb. Se strategií GovSpecs 2.0 (2025–2027)GovStack upevnil rámec, který již přijímá více než 20 zemí navrhnout vlastní architektury DPI. Od roku 2026 budou specifikace integrovat také funkce připravenosti na umělou inteligenci.
Devět základních stavebních bloků
GovStack definuje devět stavebních bloků které tvoří základ každé vládní digitální služby. Každý stavební blok je samostatně rozmístitelný, odhaluje standardizovaná rozhraní RESTful API a komunikuje spolu přes dobře definované protokoly.
| BuildingBlock | Funkce | Příklad použití |
|---|---|---|
| Identita | Ověřování a správa digitální identity | Přihlášení do veřejných služeb, KYC, digitální podpis |
| Platby | Zpracování plateb a převody | Daně, dotace, veřejné platy |
| Souhlas | Správa souhlasu pro sdílení dat | Oprávnění k přístupu ke zdravotním a daňovým údajům |
| Digitální registry | Strukturované registry směrodatných údajů | Matrika, katastr nemovitostí, obchodní rejstřík |
| Zasílání zpráv | Vícekanálová oznámení a komunikace | SMS, email, push notifikace na termíny, upozornění |
| Zprostředkovatel informací | Bezpečná výměna dat mezi systémy | Sdílení dat mezi ministerstvy, ověřování napříč databázemi |
| Registrace | Registrace pro služby a programy | Registrace školy, registrace zdraví |
| Plánovač | Rezervace schůzek a zdrojů | Schůzky ASL, rezervace dokumentů |
| Pracovní postup | Vícekroková orchestrace procesů | Žádost o stavební povolení, schvalovací proces |
# GovStack Building Block - Esempio di Architettura Completa
# Caso d'uso: Richiesta sussidio sociale
# 1. REGISTRATION BB - Il cittadino si registra alla piattaforma
POST /api/v1/registration/applications
{
"program_id": "social-subsidy-2026",
"applicant": {
"identity_ref": "ID-2026-XXXX",
"contact": {
"email": "citizen@email.com",
"phone": "+39XXXXXXXXXX"
}
}
}
# Response: { "application_id": "APP-001", "status": "SUBMITTED" }
# 2. IDENTITY BB - Verifica identità del richiedente
POST /api/v1/identity/verify
{
"identity_ref": "ID-2026-XXXX",
"verification_type": "STRONG",
"purpose": "social-subsidy-eligibility",
"required_loa": "HIGH" # Level of Assurance
}
# Response: { "verified": true, "loa": "HIGH", "method": "eID+biometric" }
# 3. CONSENT BB - Richiesta consenso per accesso dati fiscali
POST /api/v1/consent/requests
{
"subject_id": "ID-2026-XXXX",
"requester": "ministry-of-welfare",
"data_sources": [
{
"provider": "tax-authority",
"data_type": "annual_income",
"period": "2025"
},
{
"provider": "social-security",
"data_type": "employment_status",
"period": "current"
}
],
"purpose": "Verifica requisiti sussidio sociale",
"retention_period": "90d",
"expires_at": "2026-04-09T00:00:00Z"
}
# Response: { "consent_id": "CON-001", "status": "PENDING_APPROVAL" }
# 4. INFORMATION MEDIATOR BB - Recupero dati (post-consenso)
POST /api/v1/mediator/query
{
"consent_id": "CON-001",
"queries": [
{
"source": "tax-authority",
"endpoint": "/citizen/income",
"params": { "year": 2025, "citizen_id": "ID-2026-XXXX" }
},
{
"source": "social-security",
"endpoint": "/citizen/employment",
"params": { "citizen_id": "ID-2026-XXXX" }
}
]
}
# Response: aggregated data from multiple sources
# 5. WORKFLOW BB - Orchestrazione decisione
POST /api/v1/workflow/execute
{
"workflow_id": "subsidy-evaluation",
"application_id": "APP-001",
"input_data": {
"identity_verified": true,
"income_2025": 18500.00,
"employment_status": "unemployed",
"household_size": 3
}
}
# Response: { "decision": "APPROVED", "amount": 600.00, "frequency": "monthly" }
# 6. PAYMENTS BB - Erogazione sussidio
POST /api/v1/payments/disbursements
{
"beneficiary_id": "ID-2026-XXXX",
"amount": 600.00,
"currency": "EUR",
"payment_method": "bank_transfer",
"reference": "APP-001",
"schedule": {
"type": "RECURRING",
"frequency": "MONTHLY",
"start_date": "2026-04-01"
}
}
# Response: { "payment_id": "PAY-001", "status": "SCHEDULED" }
# 7. MESSAGING BB - Notifica al cittadino
POST /api/v1/messaging/send
{
"recipient_id": "ID-2026-XXXX",
"template": "subsidy-approved",
"channels": ["sms", "email", "push"],
"parameters": {
"amount": "600.00 EUR",
"start_date": "1 Aprile 2026",
"reference": "APP-001"
}
}
# Response: { "message_id": "MSG-001", "delivered": ["sms", "email"] }Rámec interoperability: X-Road a DIGIT
X-Road: Estonská digitální páteř
X Silnice je rámec interoperability vyvinutý Estonskem v roce 2001 a nyní přijatý mimo 25 zemí. Je to součást, která umožňuje bezpečnou výměnu dat mezi jakýmkoli systémem informace připojené k vládní síti a jsou vydávány jako open source pod licencí MIT od roku 2016.
Architektura X-Road je založena na třech klíčových komponentách:
- Centrální server: Udržuje registr členů, zásady zabezpečení a celkovou konfiguraci sítě
- Bezpečnostní server: nainstalován v každé zúčastněné organizaci, spravuje ověřování, autorizaci, šifrování a protokolování každé transakce
- Poskytovatel služeb/spotřebitel: informační systémy, které produkují nebo spotřebovávají služby prostřednictvím X-Road
Identity každé organizace a Security Server jsou ověřeny prostřednictvím certifikáty X.509 vydal důvěryhodná certifikační autorita. Každá zpráva je digitálně podepsána, zašifrována při přenosu a neměnně zaprotokolována na obou stranách komunikace.
# X-Road - Architettura di Interoperabilità
# Organizzazione A Central Server Organizzazione B
# +----------------+ +-------------------+ +----------------+
# | Information | | - Member Registry | | Information |
# | System A | | - Security Policy | | System B |
# | (Consumer) | | - Config Sync | | (Provider) |
# +-------+--------+ +-------------------+ +-------+--------+
# | |
# +-------+--------+ +-------+--------+
# | Security Server| <--- TLS + Signed SOAP ---> | Security Server|
# | - Auth | | - Auth |
# | - Encryption | | - Encryption |
# | - Logging | | - Logging |
# | - Timestamping | | - Timestamping |
# +----------------+ +----------------+
# Requisiti soddisfatti da X-Road:
# 1. Interoperabilità: funziona tra sistemi eterogenei con API language-agnostic
# 2. Integrita dei dati: nessuna informazione alterata durante il trasferimento
# 3. Privacy: tutti i dati cifrati, protetti da accessi non autorizzati
# 4. Non-repudiabilita: ogni transazione firmata e loggata su entrambi i lati
# Esempio di richiesta X-Road (SOAP/REST)
# Service: popolazione.anagrafe/getCitizenData/v3
{
"client": {
"xRoadInstance": "EE",
"memberClass": "GOV",
"memberCode": "70000001",
"subsystemCode": "welfare-system"
},
"service": {
"xRoadInstance": "EE",
"memberClass": "GOV",
"memberCode": "70000002",
"subsystemCode": "population-registry",
"serviceCode": "getCitizenData",
"serviceVersion": "v3"
},
"id": "REQ-2026-03-09-001",
"protocolVersion": "4.0"
}DIGIT India: Architektura zmocnění a ochrany dat
Na indické frontě rámec DIGIT (Digitální infrastruktura pro správu, dopad a transformaci) poskytuje open source platformu pro digitalizaci městských a venkovských veřejných služeb. Na rozdíl od X-Road, což je čistá vrstva interoperability, DIGIT je širší ekosystém, který zahrnuje předem vytvořené mikroslužby, analytické panely a nástroje pro zapojení občanů.
Jako doplněk k DIGIT, DEPA (architektura zmocnění a ochrany dat) definuje jako data občanů lze bezpečně sdílet napříč Agregátor účtů, regulované svěřenecké subjekty od Reserve Bank of India, která zprostředkovává tok finančních dat s výslovným souhlasem uživatele.
Návrh API pro vládní služby
Design API je technickým srdcem DPI. Vládní rozhraní API musí splňovat řadu požadavků daleko nad rámec komerčních API: dostupnost 99,99 %, letitá záruka zpětné kompatibility, komplexní audit trail, vícejazyčná podpora a soulad s národními a mezinárodními standardy.
Návrhový vzor pro vládní rozhraní API
# API Gateway per Servizi Governativi - Pattern di Riferimento
# Struttura URL standardizzata:
# /{country}/gov/api/{version}/{domain}/{resource}
# Esempi:
# GET /it/gov/api/v2/citizens/CF-XXXXXX/profile
# POST /it/gov/api/v2/welfare/applications
# GET /it/gov/api/v2/tax/declarations?year=2025
# Standard Headers (obbligatori per tutte le API governative):
#
# X-Request-ID: UUID univoco per tracciabilita
# X-Correlation-ID: ID per correlare richieste cross-service
# X-Gov-Client-ID: Identificativo del sistema chiamante
# X-Gov-Consent-Token: Token di consenso dell'utente (dove richiesto)
# X-Gov-Audit-Actor: Identificativo dell'operatore (per audit)
# Accept-Language: Lingua della risposta (it, en, de, fr, ...)
# Versionamento: URI-based per major version, header per minor
# GET /it/gov/api/v2/citizens/...
# X-Api-Version: 2.3.1
# Rate Limiting differenziato per tipo di consumer:
# - Sistemi interni PA: 10.000 req/min
# - Enti accreditati: 1.000 req/min
# - Applicazioni cittadini: 100 req/min
# - Sviluppatori (sandbox): 50 req/min
# Envelope di risposta standard:
{
"meta": {
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-03-09T10:30:00Z",
"api_version": "2.3.1",
"locale": "it-IT"
},
"data": {
# ... payload della risposta
},
"pagination": {
"total": 150,
"page": 1,
"per_page": 20,
"next_cursor": "eyJpZCI6MTIzfQ=="
},
"errors": null,
"warnings": [
{
"code": "DEPRECATED_FIELD",
"message": "Il campo 'codice_fiscale_old' sarà rimosso nella v3",
"target": "data.codice_fiscale_old"
}
]
}
# Error Response standard (RFC 7807 - Problem Details):
{
"type": "https://gov.it/errors/consent-required",
"title": "Consenso richiesto",
"status": 403,
"detail": "L'accesso ai dati fiscali richiede il consenso esplicito del cittadino",
"instance": "/it/gov/api/v2/tax/declarations?year=2025",
"extensions": {
"consent_url": "https://consent.gov.it/request/CON-001",
"required_scopes": ["tax:read:annual_income"],
"expires_in": 3600
}
}Consent Management: Srdce soukromí v IPR
Il Stavební blok souhlasu je to možná nejkritičtější součást moderního OOP, zejm v kontextech, jako je ten evropský, kde GDPR ukládá přísné požadavky. Správa souhlasu není jednoduchá „přijmout/odmítnout“: je to složitý systém, který musí spravovat granulované, odvolatelné, končící souhlasy časový plán a kompletní auditní záznam.
# Consent Management Service - Implementazione di Riferimento
# Modello dati del consenso
{
"consent_id": "CON-2026-03-001",
"version": 1,
"status": "ACTIVE", # PENDING | ACTIVE | REVOKED | EXPIRED
"subject": {
"id": "CITIZEN-ID-XXX",
"type": "NATURAL_PERSON"
},
"controller": {
"id": "MINISTRY-WELFARE",
"name": "Ministero del Lavoro e delle Politiche Sociali",
"dpo_contact": "dpo@lavoro.gov.it"
},
"purpose": {
"code": "SOCIAL_SUBSIDY_EVAL",
"description": "Valutazione requisiti per sussidio sociale",
"legal_basis": "GDPR Art. 6(1)(a) - Consenso esplicito"
},
"data_items": [
{
"source": "agenzia-entrate",
"category": "FINANCIAL",
"specific_data": ["annual_income", "tax_declarations"],
"period": "2024-2025",
"access_type": "READ_ONCE" # READ_ONCE | READ_RECURRING | STREAM
},
{
"source": "inps",
"category": "EMPLOYMENT",
"specific_data": ["employment_status", "contribution_history"],
"period": "current",
"access_type": "READ_RECURRING"
}
],
"constraints": {
"retention_period": "90d",
"geographic_restriction": "EU",
"no_automated_decisions": true,
"no_third_party_sharing": true
},
"lifecycle": {
"created_at": "2026-03-09T10:00:00Z",
"granted_at": "2026-03-09T10:05:23Z",
"expires_at": "2026-06-09T10:05:23Z",
"revoked_at": null,
"last_accessed": "2026-03-09T10:30:00Z",
"access_count": 1
},
"audit_trail": [
{
"action": "CREATED",
"timestamp": "2026-03-09T10:00:00Z",
"actor": "welfare-portal",
"ip": "x.x.x.x"
},
{
"action": "GRANTED",
"timestamp": "2026-03-09T10:05:23Z",
"actor": "citizen-wallet",
"method": "EUDI_WALLET_CONFIRM"
},
{
"action": "DATA_ACCESSED",
"timestamp": "2026-03-09T10:30:00Z",
"actor": "welfare-evaluation-service",
"data_source": "agenzia-entrate"
}
],
"signature": "<digital_signature_of_consent_record>"
}
# API per gestione consenso:
# Creazione richiesta di consenso
POST /api/v1/consent/requests
# Approvazione/rifiuto da parte del cittadino
PUT /api/v1/consent/{consent_id}/grant
PUT /api/v1/consent/{consent_id}/deny
# Revoca consenso (diritto garantito GDPR)
DELETE /api/v1/consent/{consent_id}
# Verifica stato consenso (per i data provider)
GET /api/v1/consent/{consent_id}/verify
# Response: { "valid": true, "scopes": [...], "expires_in": 7776000 }
# Lista consensi attivi per un cittadino
GET /api/v1/consent/subject/{subject_id}
# Response: lista paginata di tutti i consensi attivi/scaduti/revocati
# Audit trail completo
GET /api/v1/consent/{consent_id}/auditBezpečnost a soukromí již od návrhu v OOP
Bezpečnost v systému OOP nemůže být dodatečným nápadem: musí být integrován do DNA architektury od početí. Jak zdůraznilo Světové ekonomické fórum, principy zabezpečení od návrhu byly začleněny do biometrických protokolů Aadhaar, transakčních rámců architektur UPI a sdílení dat před registrací jednoho uživatele.
Bezpečnostní zásady OOP
| Princip | Implementace | Příklad |
|---|---|---|
| Nulová důvěra | Každý požadavek je ověřen a autorizován, žádná implicitní důvěra | mTLS napříč všemi mikroslužbami, JWT s krátkou lhůtou |
| Minimalizace dat | Sdílejte pouze data, která jsou nezbytně nutná | EUDI Wallet: ověřte věk bez prozrazení data narození |
| Šifrování všude | Šifrování při přenosu (TLS 1.3) a v klidu (AES-256) | X-Road: každá zpráva podepsaná a zašifrovaná end-to-end |
| Neměnný audit | Neměnné protokoly každé operace | Blockchainem podporovaný auditní záznam pro souhlas a přístup |
| Souhlas-první | Žádný přístup k údajům bez výslovného ověřitelného souhlasu | Agregátor účtu DEPA: podepsaný digitální souhlas |
| Federativní architektura | Žádný jediný bod selhání nebo jediný bod kompromisu | X-Road: distribuovaná data, žádná centrální databáze |
| Zabezpečení hardwaru | Kryptografické klíče v Secure Element nebo HSM | EUDI Wallet: soukromé klíče v TEE zařízení |
Poučení z výpadku UPI v dubnu 2025
12. dubna 2025 zažilo UPI největší výpadek za poslední tři roky, který trval přes 5 hodin. Analýza NPCI posmrtně odhalilo, že příčinou bylo zahlcení rozhraní API „Check Transaction Status“.: systémy neměly limit na požadavky na ověření stavu transakce. Tento případ ukazuje, že i OOPP zralejší musí přísně dodržovat zásady omezení rychlosti, přerušení obvodu a ladná degradace na každém jednotlivém koncovém bodě, včetně zdánlivě sekundárních.
Měřítko DPI: Od prototypu k národnímu měřítku
Převedení OOP z fáze prototypu do rozsahu celé populace je jednou z technických výzev složitější v technologickém prostředí. Čísla mluví sama za sebe: UPI zpracovává dál 700 milionů transakce za den, Aadhaar zpracovává stovky milionů autentizací měsíčně a X-Road v Estonsku zpracovává přes 1 miliardu dotazů ročně pro zemi s 1,3 miliony obyvatel.
Architektonické vzory pro škálovatelnost
- Event-Driven Architecture: Stavební bloky komunikují prostřednictvím asynchronních událostí, oddělují producenty a spotřebitele a umožňují nezávislé škálování
- CQRS (oddělení odpovědnosti za příkazový dotaz): oddělení operací zápisu (transakce, záznamy) a čtení (dotazy, sestavy) s databázemi optimalizovanými pro každou
- Geografické dělení: Rozdělení dat podle regionu/státu pro snížení latence a splnění požadavků na umístění dat
- Jističe: každá integrace mezi stavebními bloky chráněna jističem, aby se zabránilo kaskádovým poruchám
- Modro-zelené nasazení: aktualizace bez výpadků, kritické pro služby, které si nemohou dovolit přerušení
- Multi-Region Active-Active: Aktivní replikace napříč více datovými centry pro obnovu po havárii s RPO blízkou nule
Případová studie: Porovnání tří modelů OOP
Estonsko: e-Residency a nejdigitálnější vláda na světě
Estonsko je nejcitovanějším případem plné vládní digitalizace. S pouhými 1,3 miliony obyvatel a 99 % veřejných služeb je k dispozici online (výjimkou jsou svatba, rozvod a prodej nemovitostí, které stále vyžadují fyzickou přítomnost). Program e-Residency, spuštěna v roce 2014, umožňuje komukoli na světě získat estonskou digitální identitu a přistupovat k obchodním službám země.
Technické srdce je X Silnice, která od roku 2001 propojuje všechny veřejné informační systémy administrace. Každá organizace si uchovává svá vlastní data (princip „pouze jednou“: data jsou zaznamenána pouze jednou a v případě potřeby sdílené) a X-Road zaručuje bezpečnou, podepsanou a protokolovanou výměnu.
Indie: UPI a miliardové finanční začlenění
India Stack prokázal, že DPI může fungovat v bezprecedentním měřítku. Trasa byla: Aadhaar (identita, od roku 2009) → Jan Dhan Yojana (bankovní účty pro všechny, od roku 2014) → UPI (okamžité platby, od roku 2016) → DigiLocker (dokumenty, z roku 2015) → ONDC (obchod otevřen, od roku 2022). Tato sekvence – známá jako JAM Trinity (Jan Dhan + Aadhaar + Mobile) — přivedl více než 500 milionů lidí do formální digitální ekonomiky.
Singapur: SingPass a model Smart Nation
SingPass (Singapurský osobní přístup) slouží 97 % občanů a trvale bydlících obyvatel ve věku nad 15 let a řídí cca 300 milionů transakcí každý rok osobní i firemní, spojující přes 2 700 služeb od 800+ veřejných a soukromých subjektů. Architektura NDI (National Digital Identity). Singapur vyniká:
- Moje informace: Digitální profil předem vyplněný údaji ověřenými vládou, což eliminuje potřebu opakovaného zadávání údajů
- Ověření obličeje: Biometrické ověření obličeje pro vysoce rizikové transakce
- pan: právně platný digitální podpis integrovaný do ekosystému
- Ověřte: ověření identity osobně prostřednictvím QR kódu, bez sdílení fyzických dokumentů
| Velikost | Estonsko | Indie | Singapur | EU (eIDAS 2.0) |
|---|---|---|---|---|
| Obyvatelstvo sloužilo | 1,3 milionu + e-rezidenti | 1,4 miliardy | 5,9 milionu | 450 milionů (cíl) |
| Rok spuštění | 2001 (X-Road) | 2009 (Aadhaar) | 2003 (SingPass) | 2024 (eIDAS 2.0) |
| Identita | eID karta + Mobile-ID | Aadhaar (biometrické) | SingPass + NRIC | EUDI peněženka |
| Výměna dat | X-Road (federovaný) | DEPA + DigiLocker | MyInfo + APEX | EBSI + eDelivery |
| Platby | SEPA + e-fakturace | UPI (21,7 miliardy txn/měsíc) | PayNow + SGQR | SEPA Instant + EPI |
| Architektura | Federativní, decentralizované | Centrální spínač + API | Centralizované, nativní cloud | Na bázi peněženky, decentralizované |
| Open Source | Ano (X-Road MIT) | Částečné (MOSIP, DIGIT) | Částečná (Singapur GovTech) | V procesu definování |
| Model ochrany osobních údajů | Princip jednou | Sdílení na základě souhlasu | Centralizované s ovládacími prvky | Ochrana soukromí od návrhu, GDPR |
Zavádění OOP: Poučení
7 zlatých pravidel pro úspěšné OOPP
- Začněte s identitou: Bez robustní vrstvy identity nic nefunguje. Je předpokladem všeho ostatního.
- Otevřený standard, nepovinný open source: Specifikace by měly být otevřené, implementace se mohou lišit. GovStack ukazuje, že otevřené standardy umožňují různorodé, ale interoperabilní implementace.
- Soukromí od nultého dne: architektura musí zahrnovat konsensus, minimalizaci dat a audit trail z prvního odevzdání. Jejich pozdější přidání je exponenciálně dražší.
- Radikální modularita: Každý stavební blok musí být možné nezávisle vyměnit, upgradovat nebo škálovat. Pokud změna platebního systému vyžaduje změnu systému identity, architektura je chybná.
- Design pro selhání: v celostátním měřítku nejsou bankroty výjimkou, ale statistickou jistotou. Jistič, opakování s exponenciálním ústupem a plynulá degradace jsou povinné.
- Nejprve pískoviště: Před přechodem do produkce poskytněte kompletní prostředí sandbox, kde mohou vývojáři a entity testovat integrace. Přijetí závisí na zkušenostech vývojáře.
- Vše změřte: transakce za sekundu, latence P99, chybovost, míra přijetí, cena za transakci. Bez metrik nelze optimalizovat.
Budoucnost OOP: Trendy 2026-2030
Oblast OOP se rychle vyvíjí. Objevuje se několik trendů, které předefinují architekturu veřejných digitálních infrastruktur v nadcházejících letech:
- Připravenost na umělou inteligenci ve stavebních blocích: GovSpecs 2.0 předpokládá integraci funkcí AI-ready do specifikací stavebních bloků od roku 2026, což umožní proaktivní a prediktivní služby
- Generalizovaná ověřitelná pověření: Kromě identity se ověřitelná pověření rozšíří na vzdělání, profesní průkazy, zdravotní osvědčení a pracovní kvalifikace
- Přeshraniční OOP: Interoperabilita mezi vnitrostátními osobními ochrannými prostředky se stane normou, přičemž referenčními modely budou EUDI Wallet a export UPI
- Decentralizovaná identita (SSI): Modely Self-Sovereign Identity, kde občan plně kontroluje svá vlastní data bez závislosti na centrálním poskytovateli, získají pozornost
- Zelené OOP: Energetická účinnost a udržitelnost životního prostředí se stanou požadavky na design s metrikami uhlíkové stopy na transakci
Závěr
Digitální veřejná infrastruktura není technologický projekt: je to jeden volba sociální architektury. Rozhodnout se vybudovat sdílené, otevřené a interoperabilní stavební bloky znamená vybrat si model, kde jsou inovace je distribuován, kde jakýkoli subjekt – veřejný nebo soukromý – může budovat služby na stejných základech, a kde mezní náklady na novou digitální službu bývají nulové.
Tři modely, které jsme analyzovali — India Stack pro měřítko, Estonsko pro architektonickou eleganci, Singapur pro účinnost – prokázat, že neexistuje jediný způsob, jak zavést práva duševního vlastnictví, ale existují univerzální zásady: modularita, interoperabilita, soukromí již od návrhu, otevřené standardy a design pro případ selhání. Díky standardizaci stavebních bloků GovStack, eIDAS 2.0 přináší digitální peněženku 450 milionům Evropanů, a Indie vyvážející UPI do 25+ zemí, jsme na začátku éry, kdy se OOP stanou infrastrukturu tak zásadní, jako je elektřina nebo internet.
Pro vývojáře softwaru a architekty není porozumění vzorům DPI jen technickou dovedností: je klíč k účasti na budování digitální infrastruktury příští generace veřejných služeb.
Zdroje, kde se dozvíte více
- Specifikace GovStack: specs.govstack.global — kompletní technické specifikace stavebních bloků
- Dokumentace X-Road: x-road.global — dokumentace a zdrojový kód estonského rámce
- Indie Stack: indiastack.org — dokumentace indického ekosystému PPE
- EUDI peněženka: ec.europa.eu/digital-building-blocks — technické specifikace evropské peněženky
- Zpráva OECD PPE 2025: srovnávací analýza OOP v zemích OECD