Доступен набор интерфейсов приложений API, которые позволяют:
-
Интеграция phrase и любого стороннего программного обеспечения (Инструменты управления переводами, CMS и т. д.)
-
Разработка рабочей среды переводчика. Редактор CAT создан на основе общедоступных API.
-
Создание совершенно нового инструмента или услуги с использованием phrase в своей опоре.
Базовый рабочий процесс
Прежде чем использовать API, необходимо понять процедуры и рабочий процесс. Перед внедрением соответствующего интерфейса приложений API рекомендуется ознакомиться с процедурой в phrase.
Базовый рабочий процесс выглядит следующим образом:
-
Создайте память переводов (TM), базу терминов (TB) и дополнительно добавьте систему машинного перевода.
-
Создать проект с подключенной (при необходимости) памятью переводов (TM)/базой терминов (TB)/системой машинного перевода.
-
Сохраните проект как шаблон проекта и используйте его повторно, чтобы создать новый проект перевода.
-
Загрузите файл для перевода в проект (создайте задание).
-
Затем вы можете проанализировать, предварительно перевести или назначить задание лингвисту.
Асинхронные API
Асинхронные API всегда должны быть предпочтительны по сравнению с синхронными аналогами. При вызове синхронных интерфейсов приложений API есть вероятность получить ответы с истекшим сроком действия при обработке больших пакетов файлов или даже одного большого файла. Синхронные API следует использовать только для небольших файлов и мелкомасштабной интеграции.
Опрос
После вызова асинхронного интерфейса приложений API происходит мгновенный ответ, включающий запрос идентификатора. Используйте этот идентификатор для проверки статуса запроса, вызвав getAsyncRequest и проверив поле «Асинхронный ответ». Этот подход к опросу может привести к тому, что несколько раз будет получен запрос getAsyncRequest, прежде чем будет получен ненулевой ответ асинхронизации.
Обратные звонки
С учетом недостатков подхода опроса к асинхронным запросам поддерживается поддержка обратных вызовов во всех асинхронных интерфейсах приложений API. При вызове асинхронного запроса укажите URL- адрес (в параметре обратного URL-адреса вызова), который запрашивается после того, как работа, инициированная асинхронным запросом, будет Завершена.
Обратные вызовы запрашиваются через вызовы HTTP POST, и данные передаются в теле, закодированном как JSON. Объект JSON всегда содержит:
-
Информация об асинхронном запросе (такая же, как при вызове getAsyncRequest).
-
Подробная информация о результате действия, такая как полный анализ или сведения о задании.
{ «асинхронный запрос»: { ... } «анализ»: { ... } }
Если URL-адрес обратного вызова недоступен, запрос повторяется через 2, 4, 8, 16 и 30 минут, пока 10 повторных попыток не увенчаются успехом.
URL-адрес обратного вызова должен отвечать кодом статуса HTTP 200 OK, чтобы считаться успешным.