Pro zjištění dostupnosti lze zavolat url ve tvaru:
https://stis-api.starnet.cz/region-offer/check-region-partner/{ruianId}.
Parametr {ruianId}
je id ruianu adresy. Databázi všech adres a jejich ruian id lze
stáhnout zde: https://nahlizenidokn.cuzk.cz/stahniadresnimistaruian.aspx
V praxi pak takové volání může vypadat takto: https://stis-api.starnet.cz/region-offer/check-region-partner/17614198
Jako výsledek volání je vrácen json ve tvaru:
{"regionExist": true, "description": "Vysokorychlostní FTTw 60G připojení s rychlostí až 300 Mbps", "speed": "300", "technology": "Vysokorychlostní bezdrátové připojení FTTw 60G“, "availabilityDescription": "Objekt je v blízkosti naší sítě"}
Zde regionExist
vyjadřuje možnost pokrytí hodnotami true/false
. Pokud
je tato hodnota true
, je vrácená také technologie v atributu technology
.
Volání api je omezeno na 60 požadavků za minutu na ip adresu.