API Authentication (TMS)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

대부분의 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.

예:

ApiToken OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi

OAuth 2.0 인증

각 호출에 토큰을 보내는 대신 애플리케이션에서 OAuth 2.0을 사용하십시오. Phrase TMS는 표준 OAuth 2.0 인증 코드 부여 유형을 지원합니다.

OAuth 2.0 연결을 설정하려면 다음 단계를 따르십시오:

설정 페이지에서 아래로 스크롤하여 통합 섹션으로 이동하고 등록된 OAuth 앱을 클릭합니다.

등록된 OAuth 앱 페이지가 열립니다.
신규를 클릭합니다.

OAuth 앱 생성 페이지가 열립니다.
이름, 리디렉션 URI (콜백) 및 선택적 설명을 제공합니다.
저장을 클릭합니다.

등록된 OAuth 앱 페이지가 새 연결과 관련된 클라이언트 ID와 함께 열립니다.

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 토큰의 사용 예:

Bearer OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi