Datadepo nabízí rozhraní, přes které si vaše skripty nebo asistent Claude čtou data vašeho projektu přímo z Datadepa - bez exportních souborů a bez čekání na feed. Odpovědi jsou ve formátu JSON a mají vždy stejný tvar, takže se na ně dá spolehnout ve skriptu i v automatizaci.

Pro koho je to určené

  • Pilotní provoz: rozhraní zapínáme jednotlivým klientům na vyžádání. Napište nám, komu z vašich uživatelů ho máme zpřístupnit.
  • Nezaměňovat s API-X exporty a datovým API v1 (viz API V1 a kompletní XML export)
    • ty běží dál beze změny. Nové rozhraní je určené pro čtení dat skriptem a pro asistenta Claude.

Kde najdete správu

V hlavním menu API → API přístup (zobrazí se jen uživateli, kterému jsme přístup zapnuli). Sekce pracuje s právě zvoleným projektem - jeho název vidíte v titulku stránky. Má tři záložky:

Záložka Co v ní je
Začínáme stav přístupu (tokeny, požadavky, limity), tři kroky k prvnímu volání, připojení Claude
Tokeny a IP adresy vytvoření a zneplatnění tokenů, omezení přístupu na vybrané IP adresy
Dokumentace API úplný popis rozhraní: adresa, ověření, tvar odpovědí, chyby, limity, seznam dotazů

První kroky (stručně)

  1. V záložce Tokeny a IP adresy klikněte na Vygenerovat nový token a token si hned uložte
    • zobrazí se jen jednou. Přístup k rozhraní se pro váš projekt vytvoří automaticky s prvním tokenem.
  2. Zavolejte adresu z kroku 2 v záložce Začínáme (příkaz je připravený ke zkopírování, stačí dosadit token). Odpověď potvrdí, kdo jste a jaké dotazy smíte posílat.
  3. Volitelně připojte Claude příkazem z kroku 3 (funguje z terminálu, ne z prohlížeče). Claude pak umí data vašeho projektu číst sám - stačí se ho zeptat.

Co rozhraní vrací

  • Údaje o projektu a seznam dodavatelů - včetně jejich ID, podle kterého můžete hledat karty.
  • Karty produktů s produkty dodavatelů, kategoriemi, štítky, cenou a skladem - jen kompletní karty, tedy s kódem, aspoň jedním produktem, kategorií a vítězným produktem. U každého produktu je i kategorie, do které ho zařadil dodavatel. Karty se dají hledat podle názvu (celá slova, s diakritikou i bez), kódu, EAN, kategorie (včetně podkategorií), štítku, dodavatele, ceny od-do, toho, zda jsou skladem, a stavu schválení. Lze také najít karty bez daného štítku nebo bez jakéhokoli štítku.
  • Seznamy kategorií a štítků s jejich ID - podle nich pak hledáte karty.
  • Strom kategorií e-shopu jedním dotazem - každá aktivní kategorie s celou cestou (například „Kola > Horská kola"). Velký strom se načte po částech: nejdřív horní úrovně, pak jednotlivé větve.

Strom kategorií a kategorie od dodavatele jsou podklad pro asistenta: podle nich umí navrhnout, do které kategorie e-shopu kartu zařadit, a s oprávněním k zápisu ji i zařadit (viz níže).

Velký katalog se prochází po stránkách pomocí kurzoru: každá stránka vrátí odkaz na další, dokud nedojdete na konec. Podrobnosti, všechny filtry a příklady volání jsou v záložce Dokumentace API

  • generuje se z toho, co rozhraní skutečně umí, takže nezastarává.

Karty, kategorie a štítky patří do oprávnění Katalog. U tokenu ho zapnete v jeho oprávněních; token vytvořený před zavedením katalogu ho nemá a karty mu rozhraní nevrátí, dokud Katalog nezapnete.

Zařazování karet asistentem

Asistent (Claude, ChatGPT a další) může karty i zařazovat do kategorií e-shopu a měnit jejich štítky, až 100 karet jedním dotazem. Potřebuje k tomu token se zápisem do Katalogu: na stránce Oprávnění a dokumentace tokenu zapněte v části Pokročilé: povolení zápisu volbu Povolit zápis a u skupiny Katalog zvolte čtení i zápis. U Claude.ai a ChatGPT nabídne stejné volby obrazovka souhlasu při připojení. Token jen ke čtení zápis nevidí vůbec.

  • Asistent změnu vždy nejdřív vyzkouší nanečisto: odpověď ukáže, jaké kategorie karta měla a jaké by měla, a nic se nezapíše. Zapisuje až na váš pokyn.
  • Dávka se zapíše celá, nebo vůbec. Když nevyhovuje jediná karta, kategorie nebo štítek, nezmění se nic a odpověď vyjmenuje, co opravit.
  • Přidat lze jen aktivní kategorie vašeho stromu a karta nesmí zůstat bez kategorie. Nové štítky ani kategorie rozhraní nezakládá - asistent používá ty, které v projektu máte.
  • Karta, které asistent změní kategorie, se zamkne stejně jako po ruční úpravě v administraci, takže ji automatické párování už nemění. Máte-li v nastavení projektu zapnuté Povolit přidávání nových kategorií i v případě jejich zamčení, může jí automatické párování nové kategorie přidat. Zámek zrušíte v administraci karty, rozhraní ho neodemyká.
  • Taková karta dostane štítek Upraveno API - kategorie. Název štítku změníte nebo štítek vypnete na téže stránce tokenu v části Štítek ke změnám přes API.
  • Karty, které asistent prošel a nechal beze změny, označí týmž štítkem. Další dávku pak bere jen karty bez štítku, takže ví, kde skončil.
  • Každá změna přes rozhraní se zaznamená: který token, kdy a co na které kartě změnil.

Limity

Každý přístup má strop požadavků za minutu a za den (hodnoty vidíte v záložce Začínáme). Limit platí pro celý projekt, tedy pro všechny tokeny i připojení Claude dohromady. Po překročení rozhraní odpoví chybou „příliš mnoho požadavků" a řekne, za kolik sekund to zkusit znovu. Potřebujete vyšší limit? Napište nám.

Bezpečnost

  • Token je heslo k datům vašeho projektu: nikdy ho neposílejte e-mailem, nevkládejte do adresy a rozhraní volejte jen přes https.
  • Každý skript má mít vlastní token - zneplatnění jednoho nezasáhne ostatní.
  • Při podezření na únik token v záložce Tokeny a IP adresy zneplatněte a vytvořte nový. Staré volání dostane chybu okamžitě.
  • Omezení na IP adresy se hodí pro skripty se stálou adresou; pro práci z notebooku ho nechte vypnuté.
  • Token patří projektu, ne uživateli: odebrání přístupu do sekce token neruší. O vypnutí celého přístupu k rozhraní nás požádejte.