Co je API a jak funguje (i ve Shoptetu)

API (Application Programming Interface) je rozhraní, přes které spolu mluví dva programy. Místo klikání v administraci si jeden systém od druhého vyžádá data nebo mu pošle změnu, třeba účetní program si z e-shopu stáhne nové objednávky.

Jak API funguje

Jeden program pošle požadavek („dej mi objednávky od včerejška“) na konkrétní adresu, které se říká endpoint, a druhý vrátí odpověď s daty. Dnes se nejčastěji používá styl REST a data chodí ve formátu JSON. Dokumentace API popisuje, jaké požadavky jdou poslat a co se vrátí.

Aby si data nemohl stáhnout kdokoli, posílá se s požadavkem API klíč (token). Je to heslo pro program. Patří jen tomu, kdo napojení staví, každý partner by měl mít vlastní a jen s právy, která opravdu potřebuje.

API ve Shoptetu

Shoptet má jedno API se dvěma cestami k němu. Privátní API je přímý přístup majitele k vlastním datům a je jen pro Shoptet Premium, token se vytváří v administraci. Veřejné API používají doplňky z katalogu, takže napojení se k běžným tarifům dostane v podobě hotového doplňku. Podrobně to rozebírá průvodce Shoptet API.

API, webhook, feed a MCP

• API: ptám se, kdy potřebuju, a můžu i zapisovat.
• Webhook: systém sám dá vědět, že se něco stalo.
• XML feed: pravidelně vystavený soubor s daty, který si stahuje víc odběratelů.
• MCP: API zpřístupněné tak, aby ho mohla používat AI.

Příklad z praxe e-shopu