다음을 수행할 수 있는 API 호출 세트가 제공됩니다.
-
Phrase와 모든 타사 소프트웨어 통합(번역 관리 도구, CMS 등)
-
번역가의 워크벤치 개발 CAT 편집기는 공용 API를 기반으로 제작됩니다.
-
백엔드에서 Phrase를 사용하여 새로운 도구 또는 서비스를 만듭니다.
기본 워크플로
API를 사용하기 전에 절차 및 워크플로를 알아야 합니다. 관련 API를 구축하기 전에 Phrase의 절차에 대해 알아보는 것이 좋습니다.
기본 워크플로는 입니다.
비동기식 API
비동기식 API는 동기식 타사보다 선호해야 합니다. 동기식 API를 호출할 경우 대규모 파일 또는 단일 큰 파일을 처리할 때 시간이 초과된 응답을 받을 수 있습니다. 동기식 API는 소형 파일 및 소규모 통합에만 사용해야 합니다.
포널링
비동기식 API를 호출한 후 식별자 요청을 포함한 즉시 응답이 수신됩니다. 이 식별자를 사용하여 getAsyncRequest를 호출하고 asyncResponse 필드를 확인하여 요청의 상태를 확인합니다. 이 조회 방법은 null이 아닌 아시닝 응답을 받기 전에 여러 번 getAsyncRequest 호출을 수행할 수 있습니다.
호환
비동기식 요청에 대한 검토 방법의 장애를 해결하기 위해 모든 비동기식 API에서 콜백을 지원합니다. 비동기식 요청을 호출할 때 비동기식 요청으로 시작된 작업이 완료된 후 요청되는 URL(callbackUrl 매개 변수)을 지정합니다.
콜백은 HTTP POST 호출을 통해 요청되고 데이터는 JSON로 인코딩된 본문에서 전달됩니다. JSON 개체에 항상 포함되어 있습니다.
-
비동기식 요청에 대한 정보(getAsyncRequest을 호출할 때와 동일).
-
전체 분석 또는 작업 세부 정보와 같은 작업의 결과에 대한 상세 정보입니다.
{
"asyncRequest": {
...
}
"analyse": {
...
}
}
콜백 URL에 액세스할 수 없는 경우 2, 4, 8, 16 및 10 회 다시 실패할 때까지 30분 후에 요청이 반복됩니다.
콜백 URL은 200 OK HTTP 상태 코드로 응답해야 성공을 거두도록 합니다.