Echopix API

Veřejné rozhraní pro získání seznamu zveřejněných staveb (silniční infrastruktura ŘSD).

Účel

Endpoint vrací JSON pole se všemi veřejnými stavbami evidovanými v APDOSu — základní údaje, související soubory (mapa, leták, PDF, fotogalerie), odkazy (YouTube, externí) a kraje, kterých se stavba týká.

Endpoint

GET /api/echopix/stavby
GET /api/echopix/stavba (alias)

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/echopix/stavby?code=<API_KEY>
Host: apdos.roadmedia.cz
Accept: application/json

Tvar odpovědi

Pole objektů, jeden objekt na stavbu. Zkrácený příklad:

[
  {
    "id_stavby": 123,
    "nazev": "...",
    "kod_stavby": "...",
    "komunikace": "D1",
    "stav": "...",
    "bude_zahajeno": "2026-Q3",
    "bude_dokonceno": "2028-Q2",
    "delka": 12.5,
    "popis": "...",
    "Odkazy": [
      { "Typ": "Youtube", "Popis": "...", "URL": "https://..." },
      { "Typ": "Link",    "Popis": "...", "URL": "https://..." }
    ],
    "Soubory": {
      "Mapa":   { "URL": "https://apdos.roadmedia.cz/..." },
      "Letak":  { "URL": "...", "Velikost": 1234567, "PosledniZmena": null, "GUIDSouboru": null },
      "PDFSoubory":  [ /* ... */ ],
      "Fotogalerie": [ /* ... */ ]
    },
    "Kraje": [ { "ZkratkaCSU": "CZ010", "Nazev": "Hlavní město Praha" } ],
    "DatumVytvoreniZaznamu": "2025-01-15",
    "evidencni_cislo": "...",
    "spravce_stavby": "...",
    "gps_latitude":  50.0,
    "gps_longitude": 14.5
  }
]

Kompletní výčet polí se nachází v transformační funkci backendu; obsah pole může být postupně rozšiřován bez breaking change u stávajících klíčů.

Stavové kódy

200 OK — vrácen JSON seznam staveb
401 Unauthorized — předaný code neodpovídá serverovému klíči

Přístupový klíč

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