Jak na změnu API klíče?

V rámci zvyšování bezpečnosti našeho systému jsme se rozhodli pro úpravu identifikace při využívání API MALL Partner. Toto vyžaduje změnu využívaného identifikátoru, tedy API klíče (též client ID).

Co je to API klíč?

API klíč je identifikátor, kterým se validuje jakékoliv API volání. Tento klíč má řadu znaků, které jsou součástí URL adresy každého jednotlivého volání. Pro každý účet je API klíč unikátní.

Jak zjistím, jestli využívám API?

Využívat API je možné několika způsoby:

• provádět veškeré operace s produkty, tj. nahrávat, aktualizovat aj.
• zasílat pouze data o produktové dostupnosti
• pro práci s objednávkami
• pro získávání informací o jednotlivých kategoriích a parametrech
• můžete využívat naši API i prostřednictvím pluginů nebo dalších služeb, jako jsou například Shoptet, Baselinker, Expando a další

Zda využíváte API zjistíte ve svém partnerském portálu v nabídce Firemní profil a záložce Limity pro API.

Pokud kterákoliv kategorie má vyšší počet volání než 0, dochází k využívání API a je nutné API klíč změnit. 

POZOR!
Ve všech případech musí dojít k nahrazení původního API klíče za nový.

Kde najdu nový API klíč?

Nový API klič stejně jako všechny původní najdete v nabídce Firemní profil, záložka Informace.

Zde vidíte v sekci API klíče nejprve identifikátor samotný (sloupec client ID), dále platnost konkrétního klíče, dle které poznáte, zda se jedná o klíč nový nebo starý.

Starý API klíč má pouze uvedenou platnost “Validní do”.

Nový API klíč má pouze uvedenou platnost “Validní od”.

Jak změním API klíč?

Odpověď se liší na základě toho, zda využíváte API skrze některou ze služeb, pluginů či doplňků, nebo zda máte vytvořenou přímou integraci na MALL. Při změně pak dbejte velký důraz na následující informaci:

Po vypršení platnosti API klíče dochází k jeho deaktivaci. Tento proces je nevratný.

Služby, pluginy a doplňky

V případě, že využíváte “nepřímou” integraci na MALL například pro práci s objednávkami, nebo jako kompletní externí správu produktů, je třeba se s požadavkem na změnu API klíče obrátit na poskytovatele vašeho napojení na MALL.

Změnu API klíče pak vy, nebo poskytovatel dané služby provedete na základě specifik daného systému či služby.

Přímá integrace na MALL

Pokud máte vytvořené přímé napojení na naši API, je třeba nahradit původní API klíč novým, a to ve všech API voláních, které k nám zasíláte, ať se jedná o produktové, objednávkové nebo jiné endpointy.

Dbejte proto prosím velký důraz na kompletní nahrazení všech výskytů původního klíče novým. Jakákoliv volání zaslaná se starým klíčem budou po první využití nového klíče odmítnuta jakožto neplatná.

Pokud jste již API klíč změnili, potvrďte nám prosím tuto skutečnost v našem Centru nápovědy.

Změna klíče pro objednávkový feed

Změna API klíče se týká i objednávkových feedů. Pokud využíváte objednávkový feed, stačí si zkopírovat aktuálně dostupnou URL adresu objednávkového feedu, kterou najdete v Partnerském portálu v nabídce Firemní profil, záložce Informace.

Zde je v poli Objednávkový feed uveden aktuálně platný odkaz. Zkontrolujte prosím, zda pro vaši integraci využíváte odkaz zde uvedené. Platnost starého odkazu je spojena s platností starého klíče a je pro něj proto validní platnost z informací do “Validní do”.

Máte otázky?

Jakékoliv technické dotazy, které ke změně API klíče máte nám prosím zasílejte skrze Centrum nápovědy, kde jsme připravili novou sekci přímo pro tyto účely.