Pre-Translation

Pre-translate Crowdin project files.

Anfrage

Hinweis: Entweder die Kombination aus Projekt-ID und Projektschlüssel oder die Kombination aus Projekt-ID, Nutzername und Kontoschlüssel 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. Array keys should contain file names with path in Crowdin project.
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" — Vorübersetzung durch maschinelle Übersetzung. Sollte zusammen mit dem Parameter engine verwendet werden.
Ü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
Hinweis: Stellen Sie sicher, dass Sie den entsprechenden Schlüssel für die maschinelle Übersetzung gesetzt haben.
approve_translated optional Bool. Genehmigt automatisch übersetzte Zeichenketten. Zulässige Werte sind: „0” und „1”. Es funktioniert nur mit der Übersetzungsspeicher-Vorübersetzungs-Methode.
auto_approve_option optional Int. Definiert welche Übersetzungen, die durch die Vorübersetzung vom Übersetzungsspeicher hinzugefügt wurden, automatisch genehmigt werden sollen.
Zulässige Werte sind 0, 1 oder 2. Der Standardwert ist 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. Acceptable values are: 1 or 0. It works only with TM pre-translation method.
apply_untranslated_strings_only optional Bool. Applies translations for untranslated strings only. Acceptable values are: 1 or 0. It works only with TM pre-translation method.
perfect_match optional Bool. Pre-translate will be applied only for those strings, that have absolute match in source text and contextual information. Acceptable values are: 1 or 0. 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 Crowdin-Nutzername. Entweder project-key oder die Kombination aus login und account-key wird benötigt.
account-key String Ihr Konto-API-Schlüssel. 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?