Objednávky

GET endpoint /orders slouží k získání stránkované kolekce objednávek s podporou filtrování a řazení prostřednictvím query parametrů.

Pomocí GET 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 kategorií 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.