Параметры запроса
|
Тип данных |
Пример значения |
Описание |
|---|---|---|
|
набор символов |
windows-1250 |
Любой поддерживаемый набор символов. |
|
валюта |
EUR |
Любая поддерживаемая валюта. |
|
дата и время |
2012-07-30 17:30 |
Дата и время в формате yyyy-MM-dd HH:mm. При чтении даты всегда используется часовой пояс UTC. |
|
отрасль(тип) |
348 |
Идентификатор (ID свойства) объекта отрасли указанного типа. Например, при создании проекта в структуре JSON возвращается Идентификатор (например, 348). Этот идентификатор можно затем использовать, чтобы изменить статус проекта, установив параметр project=348. |
|
перечисление(имя) |
Значение из фиксированного набора значений. Каждый набор значений (перечисление) имеет имя. Перечисления всегда нечувствительны к регистру. |
|
|
файл |
Двоичные данные. Весь запрос должен быть отправлен в формате multipart/form-data. Примеры кода на Java и C++. |
|
|
exfile |
Совместим с типом |
|
|
jsonObject(type) |
{ 'id': 'xyz' } |
Объект указанного типа (представленный с использованием JSON-нотации). Ниже приведено описание конкретных типов. |
|
jsonObjectList(type) |
[{ 'id': 'xyz' }] |
Список объектов указанного типа (представленный с использованием JSON-нотации). |
|
язык |
en |
Любой поддерживаемый языковый код. |
|
список(тип) |
Список значений другого типа. При вызове действия API список определяется с использованием одного и того же имени параметра несколько раз (например, |
|
|
строка |
Мой проект |
Последовательность символов (в кодировке UTF-8). |
|
задача |
RiYnxBD0xBY1lwhf1 |
Идентификатор задачи перевода. Больше частей задания (если они были созданы путем разделения родительской части задания) могут использовать одну и ту же задачу. |
|
карта(тип, тип) |
Карта ключей и значений заданного типа. При вызове действия API карта определяется с использованием одного и того же имени параметра несколько раз (например, |
Ответ
Тело HTTP может содержать следующие типы данных:
-
JSON
Структура данных (в кодировке UTF-8). Каждый вызов API, возвращающий JSON, содержит пример ответа.
-
binary
Двоичные данные.
Задача vs. Часть задания
Задача
Задача представляет собой одно задание перевода (т.е. файл для перевода) на одном языке перевода. Если задание загружается для нескольких целевых языков, для каждого создаётся отдельная задача.
Если задание переводится в нескольких рабочих процессах, в каждом из них используется одна и та же задача, но различается уровень рабочего процесса. (Вот почему некоторые вызовы API имеют два аргумента для задачи и уровня.) Идентификатор задачи состоит из буквенно-цифровых символов (например, RiYnxBD0xBY1lwhf1), в то время как уровень определяется целым числом (обычно 1-10). Первый уровень в каждом проекте, использующем рабочие процессы, всегда имеет Идентификатор 1.
Задания, разделенные на несколько частей, будут иметь один и тот же идентификатор задачи, и параметр isParentJobSplit будет true.
Часть задания
часть задания представляет собой задание для целевого языка(ов) и этапов рабочего процесса. Например, один файл, импортированный в проект с 2 этапами рабочего процесса и 3 целевыми языками, приведет к 6 частям задания. Каждая часть задания может быть назначена разному лингвисту или иметь разные сроки выполнения или статус.
Каждая часть задания также может быть разделена на несколько частей задания, которые получат свой собственный Идентификатор части задания. часть задания всегда уникальна.
Типы объектов (используются в параметрах JSON)
Метаданные тега {
строка id
строка type
строка контент
строка transAttributes
}