Movisio API

Detail jedné veřejné stavby podle evidenčního čísla — vrací odkazy na mapu a leták v PDF.

Účel

Endpoint vrací základní údaje o jedné veřejné stavbě a absolutní URL na soubor mapy a PDF letáku. Slouží zejména k provázání externího systému s konkrétní stavbou v APDOSu pomocí evidenčního čísla.

Endpoint

GET /api/movisio/stavby/<evidencni_cislo>
GET /api/movisio/stavba/<evidencni_cislo> (alias)

Parametry cesty

evidencni_cislo — evidenční číslo stavby (řetězec).

Autorizace

Volitelný query parametr ?code=<API_KEY>. Pokud je hodnota uvedena, musí odpovídat klíči konfigurovanému na serveru — jinak server vrací 401 Unauthorized. Klíč obdrží partner mimo veřejné rozhraní; nezveřejňujte jej v klientském kódu.

Příklad volání

GET /api/movisio/stavby/E12345?code=<API_KEY>
Host: apdos.roadmedia.cz
Accept: application/json

Tvar odpovědi

Jeden JSON objekt:

{
  "Nazev": "...",
  "KodStavby": "...",
  "EvidencniCislo": "E12345",
  "Mapa":     "https://apdos-v2.creativesound.cz/media/.../mapa.png",
  "LetakPDF": "https://apdos-v2.creativesound.cz/media/.../letak.pdf"
}

URL souborů jsou absolutní a směřují vždy na primární doménu APDOS v2, bez ohledu na doménu, ze které bylo API zavoláno. Pokud stavba mapu nebo leták nemá, příslušné pole je prázdný řetězec.

Stavové kódy

200 OK — stavba nalezena, JSON v těle odpovědi
401 Unauthorized — předaný code neodpovídá serverovému klíči
404 Not Found — žádná veřejná stavba s daným evidenčním číslem neexistuje

Přístupový klíč

Pro zobrazení přístupového klíče se přihlaste jako administrátor.