Vorübersetzung

Pre-translate Crowdin project files.

Anfrage

Note: Use the combination of project identifier, username, and account key to pass to this endpoint.

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

Parameter

Name Wert Beschreibung
languages benötigt Array Set of languages to which pre-translation should be applied. For this use Сrowdin language codes.
files benötigt Array Files array that should be translated. Die Array-Schlüssel müssen den Dateinamen mit dem Pfad im Crowdin-Projekt beinhalten.
method optional String Definiert die Methode, die für die Vorübersetzung genutzt werden soll.
Zulässige Werte sind:
  • "tm" — Vorübersetzung durch Übersetzungsspeicher
  • "mt" — Pre-translation via Machine Translation. Should be used with engine parameter.
Übersetzungsspeicher wird standardmäßig verwendet.
engine optional String Defines engine for Machine Translation.
Zulässige Werte sind:
  • "microsoft" — Vorübersetzung durch Microsoft Translator
  • "google" — Vorübersetzung durch Google Übersetzer
  • "yandex" — Vorübersetzung durch Yandex.Translate
Note: Ensure that you have set appropriate keys for Machine Translation.
approve_translated optional Bool Automatically approves translated strings. Zulässige Werte sind: „0” und „1”. It works only with TM pre-translation method.
auto_approve_option optional Int. Definiert welche Übersetzungen, die durch die Vorübersetzung vom Übersetzungsspeicher hinzugefügt wurden, automatisch genehmigt werden sollen.
Acceptable values are 0, 1, or 2. The default value is 0.
  • "0" — alle
  • "1" — mit perfekter Übereinstimmung
  • "2" — all (skip auto-substituted suggestions)
Note:Works only when "approve_translated" parameter is used with value 1.
import_duplicates optional Bool Adds translations even if the same translation already exists. Zulässige Werte sind: „0” und „1”. It works only with TM pre-translation method.
apply_untranslated_strings_only optional Bool Applies translations for untranslated strings only. Zulässige Werte sind: „0” und „1”. It works only with TM pre-translation method.
perfect_match optional Bool Vorübersetzen wird nur für die Zeichenketten übernommen, die eine genaue Übereinstimmung im Quelltext und der Kontextinformationen haben. Zulässige Werte sind: „0” und „1”. It works only with TM pre-translation method.
json optional String Könnte keinen Wert enthalten. Defines that response should be in JSON format.
jsonp optional String Name der Rückruf Funktion. Defines that response should be in JSONP format.
Variablen
project-identifier String Projekt-ID.
login String Ihr Nutzername auf Crowdin.
account-key String Ihr Konto API-Schlüssel.

Antwort

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>

Beispiele

curl \
  -F "languages[]=fr" \
  -F "languages[]=uk" \
  -F "files[]=/example.txt" \
  https://api.crowdin.com/api/project/{project-identifier}/pre-translate?login={username}&account-key={account-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/pre-translate?login={username}&account-key={account-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;

War dieser Artikel hilfreich?