Интерфейс приложений API Phrase TMS

API (TMS)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Доступен набор вызовов API, которые позволяют:

  • интеграция Phrase и любого стороннего программного обеспечения (инструменты управления переводами, CMS и т. д.)

  • Разработка рабочей среды переводчика. Редактор CAT создан на основе общедоступных API.

  • Создание совершенно нового инструмента или сервиса с использованием Phrase.

Версия Developer

Чтобы начать использовать API, зарегистрируйтесь в версии Developer. Эта бесплатная версия предназначена для использования в качестве песочницы при разработке API. Пользователи могут использовать Postman для изучения и тестирования API.

Ограничения версии разработчика:

Разработчики могут использовать эту версию только для разработки и тестирования. Обратитесь в техподдержку, если вам необходимо увеличить или изменить эти лимиты.

  • Одновременно хранится не более 2 заданий на перевод.

  • Максимальные размеры файлов заданий - 1 МБ.

  • Не более 5 пользователей: администратор или менеджер проекта и 1 лингвист на одного администратора/менеджера проекта.

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

Базовый рабочий процесс

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

Базовый рабочий процесс:

  1. Создайте TM, TB и добавьте систему машинного перевода.

  2. Создать проект с подключением TM/TB/системы машинного перевода (при необходимости).

  3. Загрузите файл для перевода в проект (создайте задание).

  4. Затем вы можете проанализировать, предварительно перевести или поручить задание лингвисту.

Асинхронные API

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

Опрос

После вызова асинхронного API поступает мгновенный ответ, включающий запрос идентификатора. Используйте этот идентификатор для проверки статуса запроса, вызвав getAsyncRequest и проверив поле асинхронного ответа. Такой подход к опросу может привести к нескольким обращениям getAsyncRequest перед получением асинхронного ответа.

Обратные звонки

С учетом недостатков социологического подхода к асинхронным запросам поддерживается поддержка обратных вызовов во всех асинхронных API. При вызове асинхронного запроса укажите URL- адрес (в параметре обратного вызоваURL), который запрашивается после завершения работы, инициированной асинхронным запросом.

Обратные вызовы запрашиваются через HTTP POST, и данные передаются в теле, закодированном как JSON. Объект JSON всегда содержит:

  • Информация об асинхронном запросе (такая же, как при вызове getAsyncRequest).

  • Подробная информация о результате действия, такая как полный анализ или сведения о задании.

{
   "asyncRequest": {
       ...
  }
 "анализ": {   
   ...
  }
}

Если URL-адрес обратного вызова недоступен, запрос повторяется через 2, 4, 8, 16 и 30 минут, пока 10 повторов не увенчаются успехом.

URL-адрес обратного вызова должен отвечать кодом статуса 200 OK HTTP, чтобы считаться успешным.

Была ли эта статья полезной?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.