대부분의 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 인증 코드 부여 유형을 지원합니다.
OAuth 2.0 연결을 설정하려면 다음 단계를 따르십시오:
-
설정
페이지에서 아래로 스크롤하여 섹션으로 이동하고 등록된 OAuth 앱을 클릭합니다.
페이지가 열립니다.
-
신규을 클릭합니다.
페이지가 열립니다.
-
, (콜백) 및 선택적 을 제공합니다.
-
저장을 클릭합니다.
페이지가 열리고 목록에 새로운 연결과 관련된 가 표시됩니다.
ID는 Phrase에 연결하는 애플리케이션에서 연결을 설정하는 데 사용됩니다. 데이터베이스에 저장되며 요청을 적절한 요청자와 연결하는 데 사용됩니다.
-
생성된 클라이언트 ID로 인증을 위해 다음 URL을 사용하십시오:
-
인증 URL
https://cloud.memsource.com/web/oauth/authorize
-
토큰 URL
https://cloud.memsource.com/web/oauth/token
프로필이 미국 데이터 센터에 위치한 경우 cloud.memsource.com 앞에 us.을 추가하십시오. 예: https://us.cloud.memsource.com/web/oauth/authorize
-
-
인증할 때 관리자인 프로필로 로그인하고 허용을 클릭하십시오.
이제 애플리케이션이 연결되었으며 인증 API 호출이 필요하지 않습니다.
OAuth 2.0 연결이 설정되면 애플리케이션에서 사용할 수 있는 Bearer 토큰이 생성됩니다.
Bearer 토큰의 예 사용: