Best practices

API

Webhooky

• Základním pravidlem je využívat Webhooky všude, kde to jen bude možné a neposílat zbytečné pravidelné požadavky.

• Místo pravidelného stahování všech objednávek, využívejte nejlépe webhooky. V nejzažším případě můžete použít last_update_time na aktuální den, kterým si nové produkty stáhnete.

Produkty

• Seznam (GET)

  • Produkty
    • Pokud potřebujete využívat data o produktu, například při založení nové objednávky, doporučujeme provádět stažení na základě ID produktu. Kód produktu není povinný údaj a někteří klienti jej nemusí mít vyplněný.
    • Produkty není nutné stahovat každý zvlášt. Využívejte stránkování.
  • Varianty
    • Varianty je možné posílat v jednom požadavku, není nutné každou variantu posílat zvlášť.
    • Pokud chcete stahovat parametry jednotlivých produktů (variant), není nutné je stahovat samostatně. Lze použít /products/parameters, ve kterém je informace o všech produktech a variantách.

• Aktualizace (PUT)

  • Produkty
    • Pokud potřebujete produkty aktualizovat, aktualizujte pouze ta data která se změnila. Pokud budete například vkládat pouze překlady, nemusíte k tomu posílat váhu, zda-li má být produkt vložitelný do košíku, atd.

Objednávky

• Seznam (GET)
  • Pokud potřebujete mít ve svém doplňku tlačítko na stahování aktuálních objednávek, myslete nejdříve na webhooky. Pokud dané tlačítko musí být skutečně uvedeno, doporučujeme jej nastavit tak, aby nebylo možné používat opakovaně během pár sekund. Použití musí být podmíněno minimálně vždy tak, aby se dalo aktivovat až po dokončení předchozího stahování + například nějaký interval.
  • Objednávky není nutné stahovat po jedné. Využívejte stránkování.
  • Objednávky není vždy nutné stahovat všechny a z celé historie eshopu. Používejte parametry v URL adrese tak, abyste minimalizovali nároky na odpověď.

Provozovatel eshopu, Jazyky

• Tyto sekce nepotřebují pravidelné stahování. Využívejte cache

Doplňky - Best practices

Pokud jste partnerská agentura, která vytváří doplňky do Upgates, Best practices pro doplňky najdete v naší sekci pro vývojáře