Попередній переклад

Попередній переклад файлів проекту 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 обов'язковий масив Задайте мови, до яких повинен бути застосований попередній переклад. Для цього використовуйте Коди мов Сrowdin.
files обов'язковий масив Масив файлів, які потрібно перекласти. Ключі масиву повинні містити імена файлів з шляхом в проекті Crowdin.
method необов'язковий рядок Визначає, який метод буде використовуватися для попереднього перекладу.
Прийнятними значеннями є:
  • "tm" - попередній переклад через пам'ять перекладів
  • "mt" - попередній переклад за допомогою машинного перекладу. Повинен бути використаний параметр engine.
Пам'ять перекладів використовується за замовчуванням.
engine необов'язковий рядок Визначає движок для машинного перекладу.
Прийнятними значеннями є:
  • «microsoft» - попередній переклад через Microsoft Translator
  • "google" — попередній переклад через Google Перекладач
  • "yandex" - попередній переклад через Яндекс.Перекладач
Примітка: Переконайтеся, що ви призначили відповідні ключі для машинного перекладу.
approve_translated необов'язковий bool Автоматично затверджує перекладені рядки. Доступні значення: 1 або 0. Працює тільки з методом попереднього перекладу ПП.
auto_approve_option необов'язковий число Визначає, які переклади, додані попередніми перекладом через ПП, повинні бути автоматично затверджені.
Можливі значення: 0, 1 або 2. За замовчуванням значення - 0.
  • "0" — всі
  • «1» - з ідеальним збігом
  • "2" — всі (пропустити пропозиції автопідстановки)
Примітка: Працює тільки в тому випадку, якщо параметр «Approve_translated» використовується із значенням 1.
import_duplicates необов'язковий bool Додає переклад, навіть якщо такий же переклад вже існує. Доступні значення: 1 або 0. Працює тільки з методом попереднього перекладу ПП.
apply_untranslated_strings_only необов'язковий bool Переклади застосовуються тільки для неперекладених рядків. Доступні значення: 1 або 0. Працює тільки з методом попереднього перекладу ПП.
perfect_match необов'язковий bool Попередній переклад буде застосовуватися тільки для тих рядків, які мають повний збіг в тексті і контекстуальну інформацію. Доступні значення: 1 або 0. Працює тільки з методом попереднього перекладу ПП.
json необов'язковий рядок Може не містити значення. Визначає, що відповідь має бути в форматі JSON.
jsonp необов'язковий рядок Назва функції зворотного виклику. Визначає, що відповідь має бути в форматі JSONP.
Variables
project-identifier рядок Ідентифікатор проекту.
project-key рядок API-ключ проекту. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.
login рядок Ваше ім'я користувача в Crowdin. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.
account-key рядок API ключ вашого облікового запису. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.

Відповідь

Якщо метод успішний, він відповідає структурою XML, як показано нижче:
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
Якщо ви запитуєте мови, які не включені до вашого проекту, відповідь виглядає так:
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <languages>
    <language status="skipped">French</language>
  </languages>
</success>
Приклад невдалого запиту:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>Ключ API недійсний</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;

Ця стаття була корисною?