Vorübersetzung

Bitte beachten Sie, dass API 2.0 jetzt die bevorzugte Version ist. Die alte API bleibt bis Ende 2021 voll funktionsfähig.

Crowdin API v2

Pre-translate Crowdin project files.

Anfrage

Hinweis: Verwenden Sie die Kombination von Projekt-ID, Nutzername und Kontoschlüssel, um an diesen Endpunkt weiterzugeben.

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 Boolean 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 Boolean 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 Boolean Applies translations for untranslated strings only. Zulässige Werte sind: 0 und 1. It works only with TM pre-translation method.
perfect_match optional Boolean 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. Definiert, dass die Antwort im JSON-Format sein soll.
jsonp optional String Name der Rückruffunktion. Definiert, dass die Antwort im JSONP-Format sein soll.
Variablen
project-identifier String Projekt-ID.
login String Ihr Nutzername auf Crowdin.
account-key String Ihr Konto-API-Schlüssel.

Antwort

Falls die Methode erfolgreich ist, gibt sie eine XML-Struktur zurück, wie sie unten gezeigt wird:
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
Wenn Sie Sprachen anfordern, die nicht in Ihrem Projekt enthalten sind, sieht die Antwort wie folgt aus:
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <languages>
    <language status="skipped">French</language>
  </languages>
</success>
Antwort-Beispiel bei Fehlschlag:
<?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?