{"openapi":"3.1.0","info":{"title":"Open·Parlamento — API pubblica / public API","description":"**IT** — API **read-only** sui dati aperti di Open·Parlamento: knowledge graph delle relazioni tra norme, elenco e dettaglio delle norme (testo per-articolo) e relazioni di modifica. Solo letture (GET). Fonti pubbliche e citabili (ELI). I nomi legali (es. 'Codice Penale') restano in italiano per la citabilità; usa `?lang=en` o l'header `Accept-Language: en` per la prosa in inglese. CC BY 4.0 — Fonte: Normattiva (Akoma Ntoso, ELI). Strumento informativo, non consulenza legale.\n\n**EN** — **Read-only** API over Open·Parlamento open data: knowledge graph of relations between legal acts, list and detail of acts (per-article text) and amendment relations. Reads only (GET). Public, citable sources (ELI). Italian legal names (e.g. 'Codice Penale') are kept in Italian for citability; pass `?lang=en` or `Accept-Language: en` for English prose. CC BY 4.0 — Source: Normattiva (Akoma Ntoso, ELI). Informational tool, not legal advice.","contact":{"name":"Open·Parlamento","url":"https://open-parlament.xyz/","email":"open-parlament@proton.me"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"version":"1.0.0"},"paths":{"/api/public/health":{"get":{"tags":["meta"],"summary":"Stato del servizio / service status","operationId":"health_api_public_health_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/norme":{"get":{"tags":["norme"],"summary":"Elenco delle norme del corpus / list of acts","operationId":"lista_norme_api_public_norme_get","parameters":[{"name":"tipo","in":"query","required":false,"schema":{"type":"string","description":"filtra per tipo ELI (es. legge, decreto-legge, decreto-legislativo)","default":"","title":"Tipo"},"description":"filtra per tipo ELI (es. legge, decreto-legge, decreto-legislativo)"},{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"ricerca testuale nel titolo","default":"","title":"Q"},"description":"ricerca testuale nel titolo"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/norme/{eli}":{"get":{"tags":["norme"],"summary":"Dettaglio di una norma (testo per-articolo + relazioni) / act detail","operationId":"dettaglio_norma_api_public_norme__eli__get","parameters":[{"name":"eli","in":"path","required":true,"schema":{"type":"string","title":"Eli"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/relazioni":{"get":{"tags":["relazioni"],"summary":"Relazioni di modifica di una norma / amendment relations of an act","operationId":"relazioni_api_public_relazioni_get","parameters":[{"name":"norma","in":"query","required":true,"schema":{"type":"string","description":"ELI o testo libero (es. 'eli:/it/decreto-legge/2024/03/02/19' o 'DL 19/2024')","title":"Norma"},"description":"ELI o testo libero (es. 'eli:/it/decreto-legge/2024/03/02/19' o 'DL 19/2024')"},{"name":"dir","in":"query","required":false,"schema":{"type":"string","pattern":"^(out|in|entrambe)$","description":"out=cosa modifica · in=da chi è modificata","default":"entrambe","title":"Dir"},"description":"out=cosa modifica · in=da chi è modificata"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/graph":{"get":{"tags":["grafo"],"summary":"Knowledge graph delle relazioni (nodi + archi) / relations knowledge graph","operationId":"graph_api_public_graph_get","parameters":[{"name":"livello","in":"query","required":false,"schema":{"type":"string","pattern":"^(norma|articolo)$","description":"aggregazione: per norma o per articolo","default":"norma","title":"Livello"},"description":"aggregazione: per norma o per articolo"},{"name":"max_nodi","in":"query","required":false,"schema":{"type":"integer","maximum":20000,"minimum":10,"default":2000,"title":"Max Nodi"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}