Jak přistupovat k hromadnému (BULK) API volání?

Vybrané API endpointy podporují hromadné (BULK) volání. BizMachine API je schopné vrátit maximálně 250 záznamů na stránku. API lze pak dále stránkovat pomocí parametru 'offset'.

Je mnoho možností jak pomocí parametrů definovat hromadný API dotaz. Nabídka parametrů závisí vždy na konkrétním endpointu.

Kompletní přehled endpoitů a jijich parametrů naleznete v naší technické dokumentaci.

Nejčastěji používané parametry:

  • Tag.UID - API vrátí data pouze pro předem vydefinovaný seznam firem. Tag (štítek), lze vydefinovat přímo v uživatelském rozhraní Prospectoru jako "Seznam společností", zároveň umožňujeme správu tagů kompletně přes naše API.

    Typicky tedy můžu přes API nahrát list společností do tagu a následně provolat jakýkoliv datový endpoint pro tyto firmy.

  • Updeted.From, Updated.To - API vrátí pouze data která byla ve sledovaném období změněna. Typicky uživatele pouze jednorázově naimportuje všechny dostupná data a poté stačí dotazovat jen inkrement za sledované období pomocí těchto parametrů.