Vorübersetzung

Pre-translate Crowdin project files.

Anfrage

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

POST https://api.crowdin.com/api/project/{Projektkennung}/pre-translate?key={Projektschlüssel}
POST https://api.crowdin.com/api/project/{Projekt-ID}/pre-translate?login={Nutzername}&account-key={Kontoschlüssel}

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 May not contain value. Defines that response should be in JSON format.
jsonp optional String Callback function name. Defines that response should be in JSONP format.
Variablen
project-identifier String Projekt-ID.
project-key String Projekt-API-Schlüssel. Entweder project-key oder die Kombination aus login und account-key wird benötigt.
login String Ihr Nutzername auf Crowdin. Entweder project-key oder die Kombination aus login und account-key wird benötigt.
account-key String Your account API key. Entweder project-key oder die Kombination aus login und account-key wird benötigt.

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/{Projekt-ID}/pre-translate?key={Projektschlüssel}
<?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;

War dieser Artikel hilfreich?