Pre-Translation

Предварительный перевод файлов проекта Crowdin.

Запрос

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

POST https://api.crowdin.com/api/project/{project-identifier}/pre-translate?key={project-key}
POST https://api.crowdin.com/api/project/{project-identifier}/pre-translate?login={username}&account-key={account-key}

Параметры

Название Значение Описание
languages обязательный массив Набор языков, к которым должен применяться предварительный перевод. Для этого используйте коды языка Crowdin .
files обязательный массив Массив файлов, который нужно перевести. Ключи массива должны содержать имена файлов с путем в проекте Crowdin.
method необязательный строка Определяет, какой метод будет использоваться для предварительного перевода.
Допустимые значения:
  • "tm" - предварительный перевод через память переводов
  • "mt" - предварительный перевод с помощью машинного перевода. Должен использоваться с параметром engine .
Память переводов используется по умолчанию.
engine необязательный строка Определяет движок для машинного перевода.
Допустимые значения:
  • «microsoft» - предварительный перевод через Microsoft Translator
  • "google" - предварительный перевод через Google Translate
  • "yandex" - предварительный перевод через Яндекс.Переводчик
Примечание: Убедитесь, что вы установили соответствующие ключи для машинного перевода.
approve_translated необязательный булево Автоматически утверждает переведенные строки. Допустимые значения: 1 или 0. Работает только с методом предварительного перевода TM.
auto_approve_option необязательный число Определяет, какие переводы, добавленные предварительным переводом через TM, должны быть автоматически утверждены.
Допустимые значения: 0, 1 или 2. Значением по умолчанию является 0.
  • "0" — все
  • «1» - с идеальным совпадением
  • "2" — все (пропустить предложения авто-подстановки)
Примечание: Работает только в том случае, если параметр «Approve_translated» используется со значением 1.
import_duplicates необязательный булево Добавляет переводы, даже если такой перевод уже существует. Допустимые значения: 1 или 0. Работает только с методом предварительного перевода TM.
apply_untranslated_strings_only необязательный булево Применяет перевод только для не переведенных строк. Допустимые значения: 1 или 0. Работает только с методом предварительного перевода TM.
perfect_match необязательный булево Предварительный перевод будет применяться только для тех строк, которые имеют абсолютное совпадение в исходном тексте и контекстной информации. Допустимые значения: 1 или 0. Работает только с методом предварительного перевода TM.
json необязательный строка Может не содержать значение. Указывает, что ответ должен быть в формате JSON.
jsonp необязательный строка Имя функции обратного вызова. Определяет, что ответ должен быть в формате JSONP.
Variables
project-identifier строка Идентификатор проекта.
project-key строка Ключ API проекта. Требуется либо ключ проекта, либо комбинация имя пользователя и ключ аккаунта.
login строка Ваше имя пользователя в Crowdin. Требуется либо ключ проекта, либо комбинация имя пользователя и ключ аккаунта.
account-key строка API Ключ аккаунта. Требуется либо ключ проекта, либо комбинация имя пользователя и ключ аккаунта.

Ответ

If the method is successful it responds with an XML structure, as it is shown below:
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
If you request languages that are not included in your project, the response looks like:
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <languages>
    <language status="skipped">French</language>
  </languages>
</success>
Unsuccessful response sample:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>API key is not valid</message>
</error>

Примеры

curl \
  -F "languages[]=fr" \
  -F "languages[]=uk" \
  -F "files[]=/example.txt" \
  https://api.crowdin.com/api/project/{project-identifier}/pre-translate?key={project-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/pre-translate?key={project-key}';
$post_params['languages[]'] = 'uk';
$post_params['files[]'] = '/example.txt';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $request_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_params);

$result = curl_exec($ch);
curl_close($ch);

echo $result;

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