Authorization obsahovat platný token API. Tokeny jsou vázané na organizaci, ve které vznikly. Podle použitého tokenu se vrátí data této organizace.
Vytvořit token API
Vlastníci a správci organizace mohou v ClearPolicy vytvářet tokeny API.1
Otevřete nastavení API
Na nástěnce ClearPolicy přejděte na Nastavení -> API.
2
Vytvořte token
Klikněte na Vytvořit token API. Dejte tokenu srozumitelný název, například
Automatizace sestav, aby tým věděl, kde se používá.3
Zkopírujte bearer token
Token zkopírujte, jakmile ho ClearPolicy zobrazí. Po zavření dialogu už celý token znovu neuvidíte.
4
Uložte ho bezpečně
Token uložte do správce hesel, správce tajemství nebo nastavení integrace. Nesdílejte ho e-mailem, v chatu ani ve veřejném kódu.
Předání tokenu v požadavcích
Token vložte do hlavičkyAuthorization každého požadavku API:
Chybové odpovědi
Tokeny platí pro jednu organizaci. Všechny odpovědi API odpovídají organizaci, ve které token vznikl.
Přístup k API se řídí i rolí člena týmu v ClearPolicy. Vlastníci a správci mohou tokeny API vytvářet a spravovat. Tokeny vázané na správce skupiny mohou token ověřit pomocí
GET /me. Endpointy lidí, dokumentů a žádostí o potvrzení vrátí 403 Forbidden.