Většina volání API vyžaduje ověřeného uživatele. API nepoužijí žádné speciální profily uživatelů. Každé API lze volat jménem kteréhokoli stávajícího uživatele pomocí jeho uživatelského jména a hesla.
Token
Před voláním API, které vyžaduje ověřeného uživatele, volejte API auth/login, abyste získali token pro ověřování. Token je platný 24 hodin a lze jej použít pro všechna další volání. Platnost tokenu vyprší, pokud se uživatel odhlásí pomocí uživatelského rozhraní. vytvořit nový token pro každé volání.
Při dalších voláních API se získaný token použije v hlavičce Authorization. Pole s hodnotou hlavičky se vloží do ApiTokenu následovaného Space a tokenem samotným.
Pokud se uživatel odhlásí z uživatelského rozhraní, token API již nebude platný.
Příklad:
OAuth 2.0
Namísto odesílání tokenů s každým voláním použijte v aplikacích OAuth 2.0. Phrase TMS podporuje standardní typ udělení autorizačního kódu OAuth 2.0.
Připojení OAuth 2.0 vytvoříte takto:
-
Na stránce Nastavení
přejděte dolů do části a klikněte na Registered OAuth Apps.
Otevře se stránka .
-
Klikněte na Nový.
Otevře se stránka .
-
Uveďte , (Callback) a volitelný .
-
Klikněte na Uložit.
Otevře se stránka s novým připojením v seznamu a přiřazeným .
ID se použije v aplikaci, která se připojuje k Phrase, aby vytvořila spojení. Je uložen v databázi a slouží ke spárování požadavků s příslušným requesterem.
-
K ověření použijte s vygenerovaným ID klienta tyto URL:
-
Auth URL
https://cloud.memsource.com/web/oauth/authorize
-
URL tokenu
https://cloud.memsource.com/web/oauth/token
Pokud se váš profil nachází v datovém centru v USA, Přidejte nás před cloud.memsource.com, například https://us.cloud.memsource.com/web/oauth/authorize
-
-
Při autorizaci použijte profil Správce, přihlaste se a klikněte na Povolit.
Aplikace je nyní propojena a nebude vyžadováno volání API pro ověřování.
Příklad použití tokenu nositele: