Autentizace
Jak vytvoříte API token v invo.space, pošlete ho v hlavičce Authorization Bearer a jak token přejmenujete nebo smažete.
API používá tokeny. Token vytvoříte v Nastavení > API a webhooky tlačítkem Nový token a posíláte ho v každém požadavku v hlavičce Authorization: Bearer.
curl https://invo.space/api/v2/contacts?limit=10 \
-H "Authorization: Bearer VAS_TOKEN"
Vytvoření tokenu
- Otevřete Nastavení > API a webhooky.
- V části API tokeny klikněte na Nový token.
- Zadejte název, například "Integrace s e-shopem", a klikněte na Vytvořit.
- Token se zobrazí jen jednou. Zkopírujte ho na bezpečné místo a potvrďte Uložil jsem si token.
Každé integraci vytvořte vlastní token. Když ji přestanete používat, smažete jen ten jeden.
Co token smí
- Token jedná za uživatele, který ho vytvořil, a má stejná oprávnění jako jeho role v účtu. Jednotlivým tokenům oprávnění omezit nejde.
- Token patří k účtu (firmě), ve kterém jste byli při jeho vytvoření. Pro jinou firmu se do ní přepněte a vytvořte nový token.
- Token nemá datum vypršení. Platí, dokud ho nesmažete.
Token chraňte jako heslo. Nedávejte ho do kódu, který běží v prohlížeči.
Přejmenování a smazání
U každého tokenu v seznamu najdete akce Přejmenovat token a Smazat token. Smazaný token přestane fungovat okamžitě.
Chyby autentizace
Neplatný token vrátí 401 s tělem application/problem+json:
| Kód | Význam |
|---|---|
| 40101 | Chybí hlavička Authorization |
| 40102 | Hlavička má špatný tvar |
| 40104 | Neplatný podpis tokenu |
| 40106 | Token vypršel |
| 40107 | Uživatel tokenu neexistuje |
| 40108 | Neplatný token |
| 40109 | Token byl zneplatněn (smazán) |
Když token platí, ale role uživatele na akci nestačí, API vrátí 403 s kódem 40301.
Storefront token
Web e-shopu používá jiný token, poslaný v hlavičce X-Storefront-Token. Viz Storefront API.