대부분의 API 호출에는 인증된 사용자가 필요합니다. API는 특별한 사용자 프로필을 사용하지 않습니다. 각 API는 사용자 이름과 비밀번호를 사용하여 기존 사용자 대신 호출될 수 있습니다.
API로 인증하는 방법에는 두 가지가 있습니다:
-
토큰 기반 인증
-
OAuth 2.0 인증
토큰 기반 인증
인증된 사용자가 필요한 API를 호출하기 전에 auth/login API를 호출하여 인증 토큰을 획득하십시오. 토큰은 24시간 동안 유효하며 모든 후속 호출에 사용할 수 있지만, 사용자가 UI를 통해 로그아웃하면 만료됩니다. 모든 호출에 대해 새 토큰을 생성하지 마십시오.
여러 TMS 조직의 구성원은 여러 계정에 대해 동일한 사용자 이름과 비밀번호를 가집니다. 여러 계정을 사용하는 경우, 사용자가 로그인하려는 조직을 지정하기 위해 요청 본문에 userUid를 추가해야 합니다. 지정하지 않으면 사용자는 주어진 사용자 이름 및 비밀번호와 연결된 기본 계정으로 로그인됩니다.
후속 API 호출에서는 획득한 토큰이 Authorization 헤더에 사용됩니다. 헤더 값 필드는 ApiToken 뒤에 공백과 토큰 자체를 붙여서 입력합니다.
사용자가 UI에서 로그아웃하면 API 토큰은 더 이상 유효하지 않습니다.
프로필이 미국 데이터 센터에 있는 경우, cloud.memsource.com 앞에 us.를 추가하십시오. 예: https://us.cloud.memsource.com/web/api2/v3/auth/login.
예:
OAuth 2.0 인증
각 호출마다 토큰을 보내는 대신 애플리케이션에서 OAuth 2.0을(를) 사용하십시오. Phrase TMS는 표준 OAuth 2.0 authorization code grant type을(를) 지원합니다.
OAuth 2.0 연결을 설정하려면 다음 단계를 따르십시오:
-
설정
페이지에서 섹션으로 스크롤을 내리고 Registered OAuth Apps을(를) 클릭하십시오.
페이지가 열립니다.
-
신규를 클릭합니다.
페이지가 열립니다.
-
, (콜백) 및 선택 사항인 을(를) 제공하십시오.
-
저장을 클릭합니다.
페이지가 열리고 목록에 새 연결과 연결된 가 표시됩니다.
이 ID는 연결을 설정하기 위해 Phrase에 연결되는 애플리케이션에서 사용됩니다. 이는 데이터베이스에 저장되며 요청을 적절한 요청자와 연결하는 데 사용됩니다.
-
인증을 위해 생성된 클라이언트 ID와 함께 다음 URL을 사용하십시오:
-
Auth URL
https://cloud.memsource.com/web/oauth/authorize
-
Token URL
https://cloud.memsource.com/web/oauth/token
프로필이 미국 데이터 센터에 있는 경우 cloud.memsource.com 앞에 us.을(를) 추가하십시오. 예: https://us.cloud.memsource.com/web/oauth/authorize
-
-
인증할 때 관리자 프로필을 사용하여 로그인하고 Allow을(를) 클릭하십시오.
애플리케이션이 연결되었으며 인증 API 호출은 필요하지 않습니다.
OAuth 2.0 연결이 설정되면 애플리케이션에서 사용할 Bearer 토큰이 생성됩니다.
Example usage of Bearer token: