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