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/…4/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.