Phrase TMS API

API(TMS)

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

다음을 허용하는 API 호출 집합을 사용할 수 있습니다.

  • Phrase와 타사 소프트웨어(번역 관리 도구, CMS 등)의 통합

  • 번역가의 작업대 개발. CAT 편집기는 공용 API를 기반으로 구축됩니다.

  • 백엔드에서 Phrase를 사용하여 완전히 새로운 도구 또는 서비스를 만듭니다.

개발자 에디션

API 사용을 시작하려면 Developer Edition에 등록하십시오 . 이 무료 버전은 API 개발을 위한 샌드박스로 사용하도록 설계되었습니다. 사용자는 Postman 을 사용하여 API에 대해 알아보고 테스트할 수 있습니다.

Developer Edition 제한 사항:

개발자는 이 버전을 개발 및 테스트 목적으로만 사용할 수 있습니다. 이러한 제한을 늘리거나 수정해야 하는 경우 기술 지원 에 문의하십시오 .

  • 번역 작업은 한 번에 최대 2개까지 저장할 수 있습니다.

  • 작업 파일 크기는 최대 1MB입니다.

  • 관리자/PM당 최대 5명의 관리자 또는 프로젝트 관리자 사용자와 1명의 Linguist 사용자가 있습니다.

API 설명서는 전용 사이트에서 사용할 수 있습니다. 자동으로 생성되며 다운로드하여 내보낼 수 있습니다.

기본 워크플로우

API를 사용하기 전에 절차와 워크플로를 이해해야 합니다. 관련 API를 구현하기 전에 Phrase의 절차를 숙지하는 것이 좋습니다.

기본 워크플로는 다음과 같습니다.

비동기 API

비동기 API는 항상 동기 API보다 선호되어야 합니다. 동기 API를 호출하는 경우 대규모 파일 배치 또는 단일 대용량 파일을 처리할 때 시간 초과 만료 응답을 받을 수 있습니다. 동기 API는 작은 파일 및 소규모 통합에만 사용해야 합니다.

폴링

비동기 API를 호출하면 식별자 요청을 포함한 즉각적인 응답이 수신됩니다. 이 식별자를 사용하여 getAsyncRequest 를 호출 하고 asyncResponse필드를 확인하여 요청 상태를 확인합니다. 이 폴링 접근 방식은 null이 아닌 asyncResponse를 수신하기 전에 여러 getAsyncRequest 호출로 이어질 수 있습니다.

콜백을

비동기 요청에 대한 폴링 접근 방식의 단점에 대한 응답으로 모든 비동기 API에서 콜백 지원이 지원됩니다. 비동기 요청을 호출할 때 비동기 요청에 의해 시작된 작업이 완료된 후 요청되는 URL(callbackUrl 매개 변수) 을 지정합니다.

콜백은 HTTP POST 호출을 통해 요청되며 데이터는 JSON으로 인코딩된 본문에 전달됩니다. JSON 객체에는 항상 다음이 포함됩니다.

  • 비동기 요청에 대한 정보(getAsyncRequest를 호출 할 때와 동일).

  • 전체 분석 또는 작업 세부 정보와 같은 작업 결과에 대한 자세한 정보입니다.

{
   "asyncRequest": {
       ...
  }
 "analyse": {   
   ...
  }
}

콜백 URL에 액세스할 수 없는 경우 2분, 4분, 8분, 16분 및 30분 후에 10번의 재시도가 실패할 때까지 요청이 반복됩니다.

콜백 URL은 성공한 것으로 간주되기 위해 200 OK HTTP 상태 코드로 응답해야 합니다.

도움이 되었습니까?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.