Zastaralé (deprecated). API V1 je původní rozhraní DataDepa pro synchronizaci katalogu. Stávající napojení fungují dál a rozhraní dostává jen opravy, nové funkce do něj nepřibývají. Nové integrace na něm prosím nestavte - použijte kompletní XML export, nebo se ozvěte podpoře, připravujeme nové API.

API V1 slouží k pravidelnému stahování dat DataDepa do vlastního systému (repricing, sklad, katalog). Data se stahují po sekcích jako soubory ve formátu NDJSON, vždy buď celé, nebo jen změny od posledního stažení.

Sekce API

Sekce Co obsahuje
data Produktové údaje spárovaných karet: kód, název, EAN, popisy, kategorie, obrázky, parametry
business Obchodní údaje: nákupní a prodejní ceny, DPH, marže, sklad a dostupnost po dodavatelích
categories Strom kategorií e-shopu v DataDepu (ne kategorie dodavatelů)
suppliers Seznam dodavatelů projektu včetně fakturačních údajů

Popis polí jednotlivých sekcí je na stránce Struktura dat.

Přístupové údaje

Přístup zakládá podpora DataDepa na požádání. Dostanete čtyři údaje, stejné, jaké používá původní PHP knihovna DataDepo API ve svém datadepo.ini:

Údaj Hodnota
apiUrl https://client.datadepo.cz/api/
version 1
user ve tvaru kod-klienta/nazev-uctu, například moje-firma/repricing
pwd heslo účtu

Uživatelské jméno má vždy dvě části oddělené lomítkem: první je kód vašeho klientského účtu v DataDepu, druhá název konkrétního API účtu. Obě části posílejte dohromady v jednom poli user.

Účet a projekty

Jeden API účet má přístup k jednomu nebo více projektům. Pokud má účet projektů více, jsou jejich data v exportu slitá do jednoho proudu (u sekce data a categories pole project říká, ke kterému projektu záznam patří). Když potřebujete data projektů zpracovávat odděleně, například kvůli různým měnám nebo různým e-shopům, požádejte o samostatný účet pro každý projekt.

Měna cen

Ceny v sekci business jsou vždy v měně projektu, tak jak je nastavená v DataDepu. Klíč, pod kterým ceny v JSON najdete, je ale vždy prices.czk bez ohledu na měnu - název klíče se měnou neřídí a klíč prices.eur v exportu neexistuje. Detail na stránce Struktura dat.