API
le risposte ai metodi hanno tutte la medesima struttura JSON

                    {
                        "status": 0,
                        "status_description": "WT_STATUS_OK",
                        "data": ....
                    }                    
                
dove
status : integer - è il codice di esito della chiamata; 0 = OK, in tutti gli altri casi errore
status_description : string - breve descrizione dell'esito
data : object/array - è la struttura che contiene i dati ritornati in caso di esito positivo
typelists
restituisce i codici identificativi delle typelist, codici che potranno essere usati per comporre la query del metodo locations
GET
api/typelists.php
nessuno
typelists.php
regions
restituisce l'array delle regioni per cui esiste almeno un rilevamento nel database; il codice identificativo della regione potrà essere usato per comporre la query del metodo locations
GET
api/regions.php
nessuno
regions.php
provinces
dato l'identificativo della regione, restituisce l'array delle province per cui esiste almeno un rilevamento nel database; il codice identificativo della provincia potrà essere usato per comporre la query del metodo locations
GET
api/provinces.php
id_region : integer - uno degli identificativi restituito dal metodo regions
provinces.php?id_region=1
cities
dato l'identificativo della provincia, restituisce l'array dei comuni per cui esiste almeno un rilevamento nel database; il codice identificativo del comune potrà essere usato per comporre la query del metodo locations
GET
api/cities.php
id_province : integer - uno degli identificativi restituito dal metodo provinces
cities.php?id_province=1
locations
dati i parametri di query, restituisce l'array dei rilevamenti presenti nel database che soddisfano le condizioni (max 2000)
GET
api/locations.php
location_name : string case insensitive - opzionale - nome storico del toponimo da ricercare likewise
current_name : string case insensitive - opzionale - nome corrente del toponimo da ricercare likewise
relevance_year : signed integer - opzionale - anno in cui il toponimo storico è documentato
relevance_year_tolerance : integer - opzionale - nr anni di tolleranza rispetto all'anno in cui il toponimo storico è documentato
id_region : integer - opzionale - identificativo della regione su cui restringere la ricerca
id_province : integer - opzionale - identificativo della provincia su cui restringere la ricerca
id_city : integer - opzionale - identificativo del comune su cui restringere la ricerca
id_location_types : integer array - opzionale - elenco degli identificativi dei tipi toponimo su cui restringere la ricerca, separati da virgola; gli identificativi sono contenuti nell'array location_types restituiti dal metodo typelists
id_location_reliabilities : integer array - opzionale - elenco degli identificativi di affidabilità della localizzazione su cui restringere la ricerca, separati da virgola; gli identificativi sono contenuti nell'array location_reliabilities restituiti dal metodo typelists
id_year_reliabilities : integer array - opzionale - elenco degli identificativi di affidabilità dell'anno di rilevamento su cui restringere la ricerca, separati da virgola; gli identificativi sono contenuti nell'array year_reliabilities restituiti dal metodo typelists
id_attributes : integer array - opzionale - elenco degli identificativi degli attributi che, almeno uno, deve possedere il toponimo per essere restituito, separati da virgola; gli identificativi sono contenuti nell'array attributes restituiti dal metodo typelists
locations.php?location_name=taiv¤t_name=tivo&relevance_year=1000&relevance_year_tolerance=100&id_region=1&id_province=1&id_city=1&id_location_types=1,2,3&id_location_reliabilities=1,2,3&id_attributes=