{"openapi":"3.1.0","info":{"title":"DatiComuni.it API","description":"API REST per dati territoriali italiani: comuni ISTAT, meteo, geocoding e Wikipedia.","contact":{"name":"DatiComuni.it","url":"https://daticomuni.it/"},"license":{"name":"CC-BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"version":"3.0.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/health":{"get":{"summary":"Health Check","operationId":"health_check_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/metrics":{"get":{"summary":"Metrics","operationId":"metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/comuni":{"get":{"tags":["Comuni ISTAT"],"summary":"Lista comuni con filtri","operationId":"api_v1_comuni_api_v1_comuni_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":10,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"regione","in":"query","required":false,"schema":{"type":"string","title":"Regione"}},{"name":"provincia","in":"query","required":false,"schema":{"type":"string","title":"Provincia"}},{"name":"stato","in":"query","required":false,"schema":{"type":"string","title":"Stato"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/comuni/{codice_istat}":{"get":{"tags":["Comuni ISTAT"],"summary":"Dettaglio comune","operationId":"api_v1_comune_api_v1_comuni__codice_istat__get","parameters":[{"name":"codice_istat","in":"path","required":true,"schema":{"type":"string","title":"Codice Istat"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search":{"get":{"tags":["Comuni ISTAT"],"summary":"Ricerca comuni","operationId":"api_v1_search_api_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/regioni":{"get":{"tags":["Territorio"],"summary":"Lista regioni","operationId":"api_v1_regioni_api_v1_regioni_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/province":{"get":{"tags":["Territorio"],"summary":"Lista province","operationId":"api_v1_province_api_v1_province_get","parameters":[{"name":"regione","in":"query","required":false,"schema":{"type":"string","title":"Regione"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats":{"get":{"tags":["Territorio"],"summary":"Statistiche generali","operationId":"api_v1_stats_api_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/weather/{lat}/{lon}":{"get":{"summary":"Api V1 Weather","operationId":"api_v1_weather_api_v1_weather__lat___lon__get","parameters":[{"name":"lat","in":"path","required":true,"schema":{"type":"number","title":"Lat"}},{"name":"lon","in":"path","required":true,"schema":{"type":"number","title":"Lon"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/geocoding/{nome}":{"get":{"summary":"Api V1 Geocoding","operationId":"api_v1_geocoding_api_v1_geocoding__nome__get","parameters":[{"name":"nome","in":"path","required":true,"schema":{"type":"string","title":"Nome"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wikipedia/{nome}":{"get":{"summary":"Api V1 Wikipedia","operationId":"api_v1_wikipedia_api_v1_wikipedia__nome__get","parameters":[{"name":"nome","in":"path","required":true,"schema":{"type":"string","title":"Nome"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/integrated/{codice_istat}":{"get":{"summary":"Api V1 Integrated","operationId":"api_v1_integrated_api_v1_integrated__codice_istat__get","parameters":[{"name":"codice_istat","in":"path","required":true,"schema":{"type":"string","title":"Codice Istat"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/comuni":{"get":{"summary":"V1 Comuni Alias","operationId":"v1_comuni_alias_v1_comuni_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":10,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"regione","in":"query","required":false,"schema":{"type":"string","title":"Regione"}},{"name":"provincia","in":"query","required":false,"schema":{"type":"string","title":"Provincia"}},{"name":"stato","in":"query","required":false,"schema":{"type":"string","title":"Stato"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/comuni/{codice_istat}":{"get":{"summary":"V1 Comune Alias","operationId":"v1_comune_alias_v1_comuni__codice_istat__get","parameters":[{"name":"codice_istat","in":"path","required":true,"schema":{"type":"string","title":"Codice Istat"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search":{"get":{"summary":"V1 Search Alias","operationId":"v1_search_alias_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/regioni":{"get":{"summary":"V1 Regioni Alias","operationId":"v1_regioni_alias_v1_regioni_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/province":{"get":{"summary":"V1 Province Alias","operationId":"v1_province_alias_v1_province_get","parameters":[{"name":"regione","in":"query","required":false,"schema":{"type":"string","title":"Regione"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stats":{"get":{"summary":"V1 Stats Alias","operationId":"v1_stats_alias_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/weather/{lat}/{lon}":{"get":{"summary":"V2 Weather Alias","operationId":"v2_weather_alias_v2_weather__lat___lon__get","parameters":[{"name":"lat","in":"path","required":true,"schema":{"type":"number","title":"Lat"}},{"name":"lon","in":"path","required":true,"schema":{"type":"number","title":"Lon"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/geocoding/{nome}":{"get":{"summary":"V2 Geocoding Alias","operationId":"v2_geocoding_alias_v2_geocoding__nome__get","parameters":[{"name":"nome","in":"path","required":true,"schema":{"type":"string","title":"Nome"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/wikipedia/{nome}":{"get":{"summary":"V3 Wikipedia Alias","operationId":"v3_wikipedia_alias_v3_wikipedia__nome__get","parameters":[{"name":"nome","in":"path","required":true,"schema":{"type":"string","title":"Nome"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/integrated/{codice_istat}":{"get":{"summary":"V3 Integrated Alias","operationId":"v3_integrated_alias_v3_integrated__codice_istat__get","parameters":[{"name":"codice_istat","in":"path","required":true,"schema":{"type":"string","title":"Codice Istat"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/comuni":{"get":{"summary":"Api Comuni Deprecated","operationId":"api_comuni_deprecated_api_comuni_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":10,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"regione","in":"query","required":false,"schema":{"type":"string","title":"Regione"}},{"name":"provincia","in":"query","required":false,"schema":{"type":"string","title":"Provincia"}},{"name":"stato","in":"query","required":false,"schema":{"type":"string","title":"Stato"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/comuni/{codice_istat}":{"get":{"summary":"Api Comune Deprecated","operationId":"api_comune_deprecated_api_comuni__codice_istat__get","parameters":[{"name":"codice_istat","in":"path","required":true,"schema":{"type":"string","title":"Codice Istat"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/search":{"get":{"summary":"Api Search Deprecated","operationId":"api_search_deprecated_api_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/regioni":{"get":{"summary":"Api Regioni Deprecated","operationId":"api_regioni_deprecated_api_regioni_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/weather/current":{"get":{"summary":"Api Weather Current","operationId":"api_weather_current_api_weather_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/weather/{codice_istat}":{"get":{"summary":"Api Weather Comune","operationId":"api_weather_comune_api_weather__codice_istat__get","parameters":[{"name":"codice_istat","in":"path","required":true,"schema":{"type":"string","title":"Codice Istat"}}],"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"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}