AlzaTrade API - použití

Návodný popis jak využít funkcionalitu dostupnou skrze AlzaTrade API.

Objednávky

Pomocí endpointu /orders/unshipped si můžete stáhnout své neodeslané objednávky. Výsledná data lze filtrovat pomocí času odeslání zásilky od-do. Použití filtru je nepovinné, v případě nevyplnění budou vráceny všechny neodeslané objednávky.

Listování

Skupina endpointů /listings slouží pro operace k listování produktů. Aktuálně obsahuje endpointy k získání dat pro kategorie a jejich šablony, podle kterých lze zalistovat produkt.

Pro získání dostupných kategorií lze využít dvou endpointů.

  • /listings/categories - navrácená data kategorií jako jedna kolekce
  • /listings/categories/tree - navrácené kategorie ve stromové struktuře stejně tak, jako jsou vidět i v portále Alza Trade
Seznam výrobců získáte zavoláním /listings/manufacturers. Zde se žádný filtr nepoužívá, jedná se o číselník.

Pokud chcete získat šablonu pro vybranou kategorii na základě jejího ID, je nejjednodušším způsobem zavolat endpoint /listings/templates a do parametru přidat požadované ID kategorie (1 nebo více ID najednou). Použijte tento endpoint v případě, že se chystáte získat data pro nízký počet kategorií (maximálně do 50). Opakované nebo paralelní volání může vést k překročení rate limitu a vrácení HTTP kódu 429 - Too many requests.

Pokud potřebujete data pro větší počet kateogrií nebo rovnou všechny, využijte kombinaci endpointů, ze kterých lze šablonu kategorie poskládat. Jedná se o:

  • /listings/parameters - parametry s vazbou na kategorie
  • /listings/seo-prefixes - kolekce SEO prefixů s vazbou na kategorie
Zmíněné endpointy lze zavolat s nebo bez filtru kategorie. Pokud filtr nepoužijete, jsou stažena data pro všechny kategorie. Tyto operace můžou trvat delší dobu.

Máte dotaz? Napište nám