{
    "endpoint": "GET \/api — API JSON delle quotazioni immobiliari OMI (semestre 2025\/2)",
    "info": "Includi almeno un filtro nella query string per ricevere i dati; senza parametri compare solo questa documentazione.",
    "parametri": [
        {
            "parametro": "area",
            "descrizione": "Area territoriale (es. NORD-OVEST)",
            "esempio": "area=NORD-OVEST"
        },
        {
            "parametro": "regione",
            "descrizione": "Regione (in maiuscolo)",
            "esempio": "regione=PIEMONTE"
        },
        {
            "parametro": "prov",
            "descrizione": "Sigla provincia",
            "esempio": "prov=AL"
        },
        {
            "parametro": "comune",
            "descrizione": "Nome comune (in maiuscolo)",
            "esempio": "comune=ALESSANDRIA"
        },
        {
            "parametro": "zona",
            "descrizione": "Codice zona OMI (B1, C2...) — ha senso solo con comune",
            "esempio": "zona=B1"
        },
        {
            "parametro": "tipologia",
            "descrizione": "Codice numerico tipologia (20 = Abitazioni civili)",
            "esempio": "tipologia=20"
        },
        {
            "parametro": "stato",
            "descrizione": "Stato conservativo: NORMALE, OTTIMO, SCADENTE",
            "esempio": "stato=NORMALE"
        },
        {
            "parametro": "q",
            "descrizione": "Ricerca libera su comune, descrizione zona e tipologia",
            "esempio": "q=cristo"
        },
        {
            "parametro": "page",
            "descrizione": "Numero pagina (default 1)",
            "esempio": "page=2"
        },
        {
            "parametro": "limit",
            "descrizione": "Righe per pagina, max 1000 (default 100)",
            "esempio": "limit=500"
        }
    ],
    "campi_nella_risposta": [
        "comune",
        "fascia",
        "zona",
        "zona_descr",
        "cod_tip",
        "tipologia",
        "stato",
        "compr_min",
        "compr_max",
        "compr_media",
        "loc_min",
        "loc_max",
        "loc_media"
    ],
    "valori_null": "Se compr_min è null la riga ha solo dati di locazione (e viceversa); compr_media\/loc_media sono null se manca uno dei due estremi.",
    "esempio": "\/api?comune=MILANO&tipologia=20&stato=NORMALE"
}