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