Torna alla lista

Luogo v1

Restituisce un luogo Lexiper per ID. I luoghi pubblicati sono accessibili pubblicamente; le bozze richiedono autenticazione.

Endpoint

GET /api/v1/luogo/{id}

Autenticazione

Autenticazione: none

Ogni richiesta deve includere la chiave API nell'header HTTP X-API-Key.

X-API-Key: <api_key>

Se la chiave è assente o non valida l'API risponde con HTTP 401.

Parametri

Parametro Tipo Obbligatorio Descrizione
id integer Obbligatorio ID del luogo (segmento path). Esempio: /api/v1/luogo/42

Note

  • I luoghi con stato=0 (Bozza) restituiscono 401 se la richiesta non è autenticata.
  • I campi geonames_id, dbpedia_uri e osm_id sono presenti solo se valorizzati.
  • Le coordinate lat/lng sono null se il luogo non è ancora georeferenziato.

Esempio richiesta

GET https://lexiper.it/api/v1/luogo/42

Esempio risposta

{
    "status": "success",
    "data": {
        "id": 42,
        "nome": "Aci Trezza",
        "lat": 37.5623,
        "lng": 15.1641,
        "nota": "Borgo marinaro del Comune di Aci Castello.",
        "geonames_id": "2525068",
        "dbpedia_uri": null,
        "osm_id": "node\/12345",
        "stato": 1
    }
}