API-сервер для профессиональных переводов

Вы запрашиваете расчет стоимости для размещения заказа в нашей системе с помощью запроса (GET или POST) по следующему URL-адресу:

http://www.translated.com/hts/?f=YOUR-REQUIRED-FUNCTION&cid=YOUR-CUSTOMER-ID&p=YOUR-PASSWORD&s=SOURCE-LANGUAGE&t=TARGET-LANGUAGE&text=FILE-NAME&df=FILE-FORMAT&endpoint=http://www.YOUR-DOMAIN

Вот пример:

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese&text=blob&df=pdf&endpoint=http://www.your-domain.com/translations/receive

К этому моменту мы уже получим файл, сохраним его в наших системах и приступим к работе над проектом. Этот запрос сохраняется, пока мы не извлечем весь текст; чем быстрее работает ваш интернет-канал, тем лучше.

Совет: если у вас медленное интернет-соединение, предварительно загрузите файл на какой-либо сервис и пришлите нам URL-адрес этого файла в виде текстового параметра. Для получения более подробной информации см. Список функций .

Мы также попросим вас указать конечную точку для доставки переведенного файла. Обращаем ваше внимание на то, что, если конечная точка не будет указана, доставить перевод будет невозможно.

Наша система извлекает чистый текст из документа, подсчитывает количество слов (если вы явно не выполнили подсчет в запросе с помощью параметра w ,
см. Ссылки на функции для получения более подробной информации), а затем выдает ценовое предложение, содержащее следующие данные:

	Значение
1	Запрос принят
ОК	"ОК» или сообщение об ошибке, если произошел сбой
2013-09-26T15:30:00Z	Гарантированные дата и время сдачи по Гринвичу (ISO 8601)
3082	Количество слов, по нашим подсчетам
216,99	Стоимость в евро
1040734	Идентификатор для данного расчета (projectID)

Обратите внимание: ваш проект еще не начался, мы просто предоставляем вам следующую информацию:

Чтобы подтвердить заказ, вы должны отправить запрос о подтверждении .

После того как вы рассмотрели и утвердили предложение, подтвердите его, передав обратно идентификатор проекта:

http://www.translated.com/hts/?f=YOUR-REQUIRED-FUNCTION&cid=YOUR-CUSTOMER-ID&p=YOUR-PASSWORD&pid=PROJECT-ID&c=CONFIRMATION-FLAG

Пример:

http://www.translated.com/hts/?f=confirm&cid=hts-demo&p=hts-demo5&pid=1040734&c=1

Как и раньше, используйте GET или POST. Если подтверждение пройдет успешно, вы получите следующий ответ:

	Значение
1	Запрос принят
ОК	"ОК» или сообщение об ошибке, если произошел сбой

Готово! Проект утвержден и передан одному из наших менеджеров по проектам, который выберет наиболее подходящего переводчика для вашего файла. С этого момента все просто.

Получив переведенный файл от профессионального переводчика, мы тщательно проверяем его. Если перевод проходит проверку качества, файл отправляется обратно в конечную точку HTTP на вашей стороне, которую вы ранее согласовали с нами (например, http://www.yourdomain.com/translations/receive.php).

Данная конечная точка должна быть готова принять от нас запрос POST со следующими значениями:

Если вы заказали перевод на несколько языков, вы получите отдельный запрос для каждого языка перевода. Основное отличие от расчета стоимости заключается в том, что расчет – это функция, запрошенная вами, а доставка запрашивается нами.

Вот пример на PHP:

Параметр	Описание
Код завершения	1. если доставка прошла успешно – 0, если произошла ошибка
Сообщение об ошибке	"ОК", если ошибки не было, в противном случае – сообщение об ошибке. Сообщение об ошибке должно быть понятным и содержать ее описание.

Для персонализации процесса обратного вызова, пожалуйста, свяжитесь с нами по адресу: hts@translated.com.

Наш API снабжен виртуальной средой для тестовых целей, которая позволяет генерировать и отправлять нам запросы на переводы, не делая фактического заказа. Данная виртуальная среда представляет собой точную абстракцию характеристик API и позволяет вам увидеть весь процесс: от расчета стоимости до сдачи проекта.

Когда при подтверждении проекта вы отправляете запрос («f = confirm»), чтобы подтвердить этот проект как тестовый, достаточно добавить параметр “sandbox = 1”, например:

http://www.translated.com/hts/?f=confirm&cid=hts-demo&p=hts-demo5&pid=1040734&c=1&sandbox=1

Обратите внимание, что функция расчета стоимости является одинаковой и для тестирования, и для реального заказа. Кроме того, текст сообщения не будет переводом, это будет тот же текст, который вы отправили нам во время запроса стоимости.

Если в запросе указано несколько языков перевода, вы получите несколько сообщений за отрезок времени от 30 секунд до 2 минут.

Виртуальная среда содержит те же характеристики, что и реальная, и позволяет вам протестировать весь цикл интеграции.

Эта функции возвращает цену и дату выполнения перевода профессиональным переводчиком. Это первый шаг в заказе профессионального перевода с использованием HTS.

Для возвращения допустимого значения на данном этапе необходим как минимум текст или параметр w. Это означает, что вы можете получить расчет стоимости без фактической отправки документа, если укажете количество слов.

Функция расчет стоимости принимает следующие параметры:

Параметр	Описание	По умолчанию	Пример
cid	Имя пользователя	/	cid=hts-demo
р	Пароль	/	p=hts-demo5
s	Исходный язык	/	s=English
t	Язык(и) перевода Значения, разделенные запятыми, для нескольких языков	/	t=Italiant =Italian,Spanish,Japanese
text	Содержимое, которое необходимо перевести. Это может быть простой строковый текст или URL-адрес, указывающий на файл. Обратите внимание, что это необязательно, если указан параметр w.	/	text = Hello worldtext = "http://www.translated.com/hts/HTS_Tech_Spec.pdf"
pn	Название проекта	HTS-NONAME	pn=Translation for tomorrow nr°2
jt	Типы проектов: ⇥⇥⇥⇥⇥⇥ T – Профессиональный⇥⇥⇥⇥⇥⇥ R – Премиум ⇥⇥⇥⇥⇥⇥ P – Экономный	T	jt=R
w	Количество слов в файле. С помощью этого параметра наш сервер осуществляет подсчет количества слов в файле в реальном времени, что позволяет быстрее получить ответ.	/	w=5120
df	Формат данных и расширение файла. Требуется для автоматического подсчета количества слов. Автоматический подсчет количества слов доступен только для: 'pdf', 'plaintext','txt', 'xml', 'html', 'htm', 'xliff', 'zip','rtf', 'doc','docx','aea'. Для отправки нескольких сжатых файлов, укажите формат «zip», и система автоматически распознает формат файла контента.	/	df=zip
tm	Память переводов, которую вы хотите использовать для этого проекта. Что касается текстового параметра, это может быть файл или URL. Обратите внимание, что вы также можете передать ключ MyMemory.	/	tm=823yuc908237 tm=http://www.yousite.net/hts/some_memory.tmx
endpoint	URL-адрес, на который мы отправим перевод. Мы рекомендуем вам произвести URL-кодирование конечной точки, чтобы избежать проблем с обработкой, особенно в том случае, если ваша ссылка содержит “&” или другие специальные символы	/	endpoint=http://www.mysite.com/path/to/mypage.extURL ­-URL­-encoded:endpoint=http%3A%2F%2Fwww.mysite.com%2Fpath%2Fto%2Fmypage.ext
subject	Тема документа, который вы отправляете. Ознакомьтесь с полным списком тем, поддерживаемых API.	general	subject=accounting_finance
instructions	Добавьте инструкции для переводчика в виде простого текста	/	instructions=пожалуйста, оставьте строчные буквы; данные в формате US

Пример

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese,italian&text=http://www.translated.com/hts/HTS_Tech_Spec.pdf&df=pdf&jt=P&pn=SimpleTest&w=3000

Функциярасчет стоимости возвращает следующие значения:

Параметр	Описание	Пример
код завершения	1 – процедура прошла успешно, 0 – произошла ошибка	1
сообщение об ошибке	"OK", если ошибки не было, в противном случае сообщение	ОК
дата сдачи	Гарантированные дата и время сдачи заказа по стандарту ISO 8601: ГГГГ-ММ-ДДТЧЧ:мм:сс	2013-02-18T12:32:00Z
количество слов	Количество слов, указанное в текстовом параметре, либо подсчитано нами, либо предоставлено пользователем с помощью параметра “w”	456
стоимость в евро	Стоимость заказа в евро указывается в числовом формате без разделителей тысяч и "." в качестве десятичного разделителя	223.33
идентификатор проекта	Идентификатор проекта, который необходим для подтверждения заказа	10454289

Эта функция подтверждает запрос о расчете стоимости профессионального перевода, отправленный ранее Это второй и последний шаг для размещении заказа на перевод с помощью HTS.

Функция подтверждение принимает следующие параметры:

Параметр	Описание	По умолчанию	Пример
cid	Имя пользователя	/	cid=hts-demo
р	Пароль	/	p=hts-demo5
pid	Идентификатор проекта, который необходим для подтверждения заказа	/	pid=10454289
c	Значок подтверждения. Чтобы подтвердить ценовое предложение, внутри функции «подтвердить» добавьте 1 к этому параметру, если вы хотите отклонить предложение, добавьте 0.	/	c=1 c=0
sandbox	Тестовый режим. В этом режиме проект рассматривается как тест, а контент для перевода отправляется на конечную точку без изменений. Вы ничего не платите.	0	sandbox=1
text	Содержимое, которое необходимо перевести. Это может быть: простой строчный текст URL-код, указывающий на файл	/	text=Hello world text=http://www.translated.com/hts/HTS_Tech_Spec.pdf

Пример

http://www.translated.com/hts/?f=confirm&cid=hts-demo&p=hts-demo5&c=1&pid=232451

Функция подтверждения возвращает следующие значения:

Параметр	Описание	Пример
код завершения	1 – процедура прошла успешно, 0 – произошла ошибка	1
сообщение об ошибке	"OK", если ошибки не было, в противном случае сообщение	ОК

Эта функция позволяет отслеживать статус всех проектов, которые вы предоставили.

Функция статуса принимает следующие параметры:

Параметр	Описание	По умолчанию	Пример
cid	Имя пользователя	/	cid=hts-demo
р	Пароль	/	p=hts-demo5
pid	Идентификатор проекта, который необходим для подтверждения заказа	/	pid=10454289

Пример

http://www.translated.com/hts/?f=status&cid=hts-demo&p=hts-demo5&c=1&pid=232451

Функция статуса возвращает следующие значения:

Параметр	Описание	Пример
код завершения	1 – процедура прошла успешно, 0 – произошла ошибка	1
сообщение об ошибке	"OK", если ошибки не было, в противном случае сообщение	ОК
список заданий, относящихся к проекту, по одному на каждую строку, со значениями, разделенными точкой с запятой	строка задания состоит из: id; job_type; source; target; words; customer_total; order_date; delivery_date; pm; pm_email	задание в одной строке: REVISION;Italian;English;182;10.00;IN PROCESS;2012­-11­-29 T15:35:00Z;2013­-01-­25 T16:00:00Z;GIANFRANCO;gianfranco@translated.com

Эта функция показывает список кодов языков, поддерживаемых для профессионального перевода (для параметров исходного и целевого языка ценового предложения и функций подтверждения). Список содержит код RFC 3066 и две или три буквы кода ISO.

Эта функция должна использоваться для периодического обновления списка поддерживаемых языков в вашей системе.

Функция ll принимает следующие параметры:

Параметр	Описание	По умолчанию	Пример
cid	Имя пользователя	/	cid=hts-demo
р	Пароль	/	p=hts-demo5

Пример

http://www.translated.com/hts/?f=ll&cid=hts-demo&p=hts-demo5

Функция ll возвращает следующие значения:

Параметр	Описание	Пример
код завершения	1 – процедура прошла успешно, 0 – произошла ошибка	1
список языков	линия состоит из имени языка, кода RFC3066, кода ISO 6391, кода ISO 6392	Amharic;am­AM;am;amh

Эта функция показывает список кодов тем, доступных для профессионального перевода. Эта функция должна использоваться для периодического обновления списка доступных тем в вашей системе.

Функция Тема принимает следующие параметры:

Параметр	Описание	По умолчанию	Пример
cid	Имя пользователя	/	cid=hts-demo
р	Пароль	/	p=hts-demo5

Пример

http://www.translated.com/hts/?f=ll&cid=hts-demo&p=hts-demo5

Функция Тема возвращает следующие значения:

Параметр	Описание	Пример
код завершения	1 – процедура прошла успешно, 0 – произошла ошибка	1
список тем	Тема документа, который вы хотите перевести	accounting_finance aerospace_defence architecture

Предложение действует в течение 24 часов.

Мы поддерживаем любые файлы, так как HTS это просто способ размещать заказы и передавать файлы непосредственно на наши серверы. Тем не менее, некоторые функции, например, автоматический подсчет слов, доступны только для файлов в форматах pdf, txt, xml, html, xliff, rtf, doc, aea. В случае других форматов необходимо выполнить подсчет слов вручную, а затем отправить нам точное количество слов с помощью специального параметра (см, функцию расчета стоимости в Списке функций).

Документы доставляются по протоколу HTTP POST в общедоступную конечную точку по вашему выбору. Пожалуйста, не забудьте предоставить нам эту информацию, в противном случае мы не сможем доставить переводы вам переводы.

Мы вышлем вам счет по каждому проекту, который вы сможете оплатить в течение 5 дней. Если речь идет о больших объемах или регулярных заказах, мы можем отправлять счет ежемесячно.

Да, цена одинаковая. Обратите внимание, что, чем больше технической работы нам приходится выполнять, чтобы извлечь текст из файла, тем дольше будет задержка.

Система автоматизирует подсчет слов, анализируя ваш файл, извлекая из него текст и подсчитывая слова. Некоторые форматы файлов, такие как Word, могут включать дополнительные метаданные (комментарии к файлам, сведения об авторе и т. д.), которые тоже извлекаются. Это может привести к незначительной разнице в количестве слов. Translated гарантирует, что наши менеджеры проводят тщательную проверку каждого файла перед началом перевода, чтобы убедиться в отсутствии расхождений в количестве слов.

Да. Наш API поддерживает файлы любого формата; указанные выше форматы доступны для автоматического подсчета слов в режиме онлайн.

Свяжитесь с нами по адресу: hts@translated.com , и мы будем рады обсудить вашу просьбу.

Отправьте список значений, разделенных запятыми, в параметре запроса «t», например:

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese,italian,spanish&text=blob&df=pdf&endpoint=http://www.your-domain.com/translations/receive

Вместо параметра “text” воспользуйтесь параметром "w", например:

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese&w=1000&df=pdf&endpoint=http://www.your-domain.com/translations/receive

Наш API по умолчанию отвечает чистым текстом, однако если вы укажете “of=json”, он вернет ответ в формате JSON. Этот дополнительный параметр поддерживается всеми функциями API («quote», «confirm», «status», «ll», «subject»).

В нашем API предусмотрена виртуальная среда для тестирования всего цикла процессов без совершения реального заказа. За тестовые проекты не взимается никакой платы, и количество созданных виртуальных проектов может быть неограниченным. Подробное описание находится в соответствующем разделе.