Meteo osondy odesílají data každou minutu do databáze na server vetromerka.cz. Takto uložená data jsou zobrazována na WEBu vetromerka.cz. Pro externí aplikace je k disposici API rozhraní, které poskytuje data ze zvolené sondy za zvolené období.

Minimální interval měření (minIterval) = 60sekund.

Maximální počet vrácených záznamů (maxItems) pro 1 request = 1000

Některé sondy hlavně z důvodu úspory energie omezují svůj provoz v nočních hodinách.

Z pohledu uzivatele API se jedna o jednoduche, read-only REST-like API, ktere prijima HTTP GET s parametry v URL query argumentech a jako odpoved vraci JSON se spravne vyplnenou hlavickou Content-Type

Pokud bude Content-Type text/html pak se nejspis jedna o chybovou hlasku IIS a ne samotneho API tj. API crashnulo a nepovedlo se ho znovu spustit nebo je v nem programming chyba pro dany request

API podporuje HTTPS, je provozovano na domene “api.vetromerka.cz” a requesty ocekava na statickem URL endpointu “/v1/meteodata”

Struktura requestu, stejne jako odpovedi je definovana zde

Vsechny vstupni/vystupni casy vzdy interpretovany/zobrazovany jako lokalni cas sondy.

API vyzaduje povinny parametr probe, ktery urcuje danou sondu - na vyber je z hodnot {rasovka, ceskydub, vsen}

API zaroven vyzaduje autentizaci, tj v parametrech “user” a “pass” ocekava uzivatelske jmeno a prislusne heslo

Parametry “user” a “pass” si vyžádejte na z.cendra@atlas.cz

Tipicke volani API:
curl -v --compressed https://api.vetromerka.cz/v1/meteodata?user=XXX&pass=YYY&probe=rasovka