요청 매개변수
|
데이터 유형 |
샘플 값 |
설명 |
|---|---|---|
|
문자셋 |
windows-1250 |
지원되는 문자셋을 사용할 수 있어. |
|
통화 |
EUR |
지원되는 통화을 사용할 수 있어. |
|
날짜 및 시간 |
2012-07-30 17:30 |
yyyy-MM-dd HH:mm 형식의 날짜 및 시간이야. 날짜를 읽을 때는 항상 UTC 시간대를 사용해. |
|
도메인(type) |
348 |
지정된 유형의 도메인 객체의 식별자 (ID 속성)이야. 예를 들어, 프로젝트를 생성하면 JSON 구조에서 ID(예: 348)가 반환돼. 이 식별자는 나중에 project=348 파라미터를 설정해서 프로젝트의 상태를 변경하는 데 쓸 수 있어. |
|
열거형(이름) |
고정된 값 집합 중 하나야. 각 값 집합(enum)에는 이름이 있어. Enums는 항상 대소문자를 구분하지 않아. |
|
|
파일 |
이진 데이터야. 전체 요청은 multipart/form-data 형식으로 보내야 해. Java 및 C++ 코드의 예제야. |
|
|
exfile |
호환돼. File AP의 핸들도 받아. |
|
|
jsonObject(type) |
{ 'id': 'xyz' } |
지정된 유형의 객체( JSON 표기법으로 표현돼). 특정 유형에 대한 설명은 아래를 참고해. |
|
jsonObjectList(type) |
[{ 'id': 'xyz' }] |
지정된 유형의 객체 목록(JSON 표기법으로 표현돼). |
|
lang |
en |
지원되는 언어 코드<1>를 사용할 수 있어. |
|
list(type) |
다른 유형의 값 목록이야. API 작업을 호출할 때 목록은 동일한 매개변수 이름을 여러 번 사용하여 정의돼 (예: |
|
|
문자열 |
내 프로젝트 |
문자 시퀀스(UTF-8 인코딩돼). |
|
과업 |
RiYnxBD0xBY1lwhf1 |
번역 과업의 식별자야. 더 많은 작업부분(상위 작업부분을 분할하여 생성된 경우)은 같은 과업을 공유할 수 있어. |
|
map(type, type) |
주어진 타입의 키와 값으로 이루어진 맵이야. API 작업을 호출할 때, 맵은 동일한 파라미터 이름을 여러 번 사용하여 정의돼 (예: |
응답
HTTP 본문에는 다음과 같은 데이터 유형이 포함될 수 있어:
-
JSON
데이터 구조(UTF-8 인코딩돼). 각 API 호출이 JSON을 반환할 때, 응답 예시를 포함해.
-
binary
바이너리 데이터야.
과업 vs. 작업부분
과업
과업은 하나의 대상 언어로 번역할 작업을 나타내. 하나의 작업이 더 많은 대상 언어로 업로드되면, 각 대상 언어에 대해 독립적인 과업이 생성돼.
작업이 여러 워크플로에서 번역되면, 각 워크플로는 동일한 과업을 공유하지만 워크플로 단계가 달라. (이것이 일부 API 호출이 과업과 수준에 대해 두 개의 인수를 가지는 이유야.) 과업 식별자는 영숫자 문자로 구성돼 (예: RiYnxBD0xBY1lwhf1) 반면, 수준은 정수로 식별돼 (보통 1-10). 워크플로를 사용하는 각 프로젝트의 첫 번째 수준은 항상 식별자 1을 가져.
여러 부분으로 분할된 작업은 동일한 과업 ID를 가지며, 매개변수 isParentJobSplit는 true가 돼.
작업부분
작업부분은 대상 언어와 워크플로 단계별로 하나의 작업을 나타내. 예를 들어, 2개의 워크플로 단계와 3개의 대상 언어가 있는 프로젝트에 가져온 단일 파일은 6개의 작업부분을 생성해. 각 작업부분은 다른 번역자에게 할당되거나 다른 기한이나 상태를 가질 수 있어.
각 작업부분는 여러 개의 작업부분로 분할될 수 있고, 각 작업부분 ID를 갖게 돼. 작업부분은 항상 고유해.
객체 유형 (JSON 매개변수에서 사용돼)
TagMetadata {
문자열 ID
문자열 유형
문자열 컨텐츠
문자열 전송 속성
}