Dva způsoby přístupu
API klíč
Klíč vytvořený v administraci. Používá ho aplikace, která pracuje sama za sebe — export do srovnávače, synchronizace skladu. Klíč má nastavená oprávnění (scopy) a expiraci.
Přihlášení uživatele
Když aplikace pracuje jménem konkrétního člověka (mobilní aplikace s přihlášením), použije se přihlášení. K dispozici jsou endpointy pro:
- registraci účtu
- ověření e-mailu a opětovné odeslání ověřovacího odkazu
- přihlášení a odhlášení
- obnovu přihlášení (refresh)
- zapomenuté heslo a jeho reset
- informace o přihlášeném uživateli
- správu jeho tokenů
Oprávnění (scopy)
Klíč nemá automaticky přístup ke všemu. Při vytváření vybíráte, co smí:
- jen čtení určitého druhu obsahu
- čtení i zápis
- Full access — vše
Zásada: dávejte nejmenší potřebná oprávnění. Aplikace, která články jen zobrazuje, nepotřebuje právo je mazat.
Povolené adresy (origins)
Když data čte aplikace běžící v prohlížeči, musí být její adresa uvedená mezi povolenými API origins v nastavení webu — jinak prohlížeč požadavek zablokuje. Viz Proměnné webu: Headless a API režim.
Ověřovací odkaz u headless aplikací
Když registrace probíhá v cizí aplikaci, musí ověřovací odkaz z e-mailu vést zpátky do ní. Nastavuje se to volbou Ověřovací odkaz z registračního e-mailu — hlavní web, headless doména, nebo vlastní adresa.
