Большинство вызовов интерфейс приложений API требуют аутентифицированного пользователь. Интерфейс приложений API не использовать какие-либо специальные профиль пользователь. Каждый интерфейс приложений API можно вызвать от имени любого существующего пользователь, используя его имя пользователя и пароль.
Существует два метода аутентификация с помощью интерфейс приложений API:
-
Аутентификация на основе токен
-
Аутентификация OAuth 2.0
Аутентификация на основе токен
Перед вызовом любого интерфейс приложений API, требующего аутентифицированного пользователь, вызовите интерфейс приложений API auth/login, чтобы получить токен аутентификация. Токен действителен в течение 24 часов и может использоваться для всех последующих вызовов, но он станет недействительным, если пользователь выйдет из системы через пользовательский интерфейс. Не нужно Создать новый токен для каждого вызова.
Участники нескольких организаций TMS имеют одинаковые имя пользователя и пароль для нескольких учетная запись. Если используется несколько учетная запись, userUid должен быть добавлен в тело запроса, чтобы указать, в какую организация пользователь хочет войти. Если не указано иное, пользователь входит в учетная запись по умолчанию, связанную с заданными именем пользователя и паролем.
В последующих вызовах интерфейс приложений API полученный токен используется в заголовке Authorization. Поле значения заголовка начинается с ApiToken, за которым следует каталог и сам токен.
Если пользователь выходит из пользовательского интерфейса, токен интерфейс приложений API перестанет быть действительным.
Если профиль находится в центре обработки данных США, добавьте us. перед cloud.memsource.com, например https://us.cloud.memsource.com/web/api2/v3/auth/login.
Например:
Аутентификация OAuth 2.0
Использовать OAuth 2.0 в приложениях вместо отправки токенов с каждым вызовом. Phrase TMS поддерживает стандартный authorization code grant type OAuth 2.0.
Чтобы установить соединение OAuth 2.0, выполните следующие действия:
-
На странице настройки
прокрутите вниз до раздела и нажмите на Registered OAuth Apps.
Откроется страница .
-
Нажмите «Создать».
Откроется страница .
-
Укажите , (Callback) и необязательное .
-
Нажмите Сохранить.
Откроется страница с новым соединением в список и связанным .
Идентификатор используется в приложении, которое подключается к Phrase для установления соединения. Он хранится в базе данных и используется для сопоставления запросов с соответствующим запрашивающим лицом.
-
Использовать эти URL-адреса с созданным Идентификатор клиент для авторизации:
-
Auth URL
https://cloud.memsource.com/web/oauth/authorize
-
Token URL
https://cloud.memsource.com/web/oauth/token
Если профиль находится в центре обработки данных США, добавить us. перед cloud.memsource.com, например https://us.cloud.memsource.com/web/oauth/authorize
-
-
При авторизации использовать профиль администратор для входа в систему и нажать Allow.
Приложение теперь связано, и вызов интерфейс приложений API аутентификация не потребуется.
После установления соединения OAuth 2.0 создается токен Bearer для использования в приложении.
Example usage of Bearer token: