XML

XML, JSON, CSV pro střední až velké obchody

• Nabízíme vždy aktuální přístup ke kompletním informacím o pobočkách
  • XML export: http://www.zasilkovna.cz/…6/branch.xml.
  • XML schéma daného exportu: http://www.zasilkovna.cz/…3/branch.xsd.
  • JSON se stejnou strukturou: http://www.zasilkovna.cz/…/branch.json
    • navíc je zde order, pořadí poboček dle země a názvu
    • soubor je možno přímo načítat z libovolné domény v prohlížečích podporujících CORS
    • podpora JSONP: http://www.zasilkovna.cz/…/branch.json?…
  • stručný CSV export: http://www.zasilkovna.cz/…6/branch.csv
  • informační popis jednotlivých polí
• Dále můžete také využít JS API z průvodců pro malé až střední obchody výše.
  • Doporučujeme ale, abyste soubor API http://www.zasilkovna.cz/…e6/branch.js stáhli k sobě na server a automaticky jej jednou denně synchronizovali. Pro aktualizace JS API souboru platí stejná pravidla jako pro XML export, viz níže. Tímto získáte nezávislost na případném výpadku našeho serveru.
  • Můžete si stáhnout ukázku „offline“ použití JS API.
• Adresy exportu obsahují unikátní klíč pro Váš uživatelský účet. V případě, že máte více uživatelských účtů, je nutné použít pro každý obchod správný klíč API, abychom věděli, že exporty skutečně používáte. Používání exportů bude v budoucnu povinné.
• Synchronizaci byste měli provádět jednou denně. všechny exporty a JS API jsou aktualizovány každý den mezi 0:00 a 1:00.

  V žádném případě byste neměli k seznamům poboček na našich serverech přistupovat blokujícím způsobem přímo při zobrazení košíku apod.,

  tj. např. v serverové části kódu zobrazujícího nákupní košík načítat XML seznam přímo od nás. Pokud tak přes toto upozornění učiníte, neneseme žádnou zodpovědnost za problémy s použitím Vašeho obchodu způsobené případným výpadkem našeho serveru.
• Je nutné ošetřit chybový stav, kdy selže načtení XML exportu (např. se nepodaří spojit s naším serverem, XML export se nepodaří zparsovat apod.), a to tak, že zachováte data z posledního úspěšného načtení. V žádném případě nesmí dojít k vyprázdnění databáze poboček ve vašem obchodu.