Előfordítás

Please consider that API 2.0 is now the preferred version to be used. The old API will remain fully functional until the end of 2021.

Crowdin API v2

Crowdin projektfájlok előfordítása.

Kérelem

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}

Paraméterek

Név Érték Leírás
languages szükséges array Olyan nyelvek készlete, amelyekre az előfordítást alkalmazni kell. Ehhez használja a Сrowdin nyelvkódokat.
files szükséges array Lefordítandó fájlok tömb. A tömbök kulcsainak tartalmazniuk kell a a Crowdin projekt fájlneveit elérési úttal.
method opcionális string Meghatározza, hogy melyik módszer kerül az előfordítás során használatra.
Elfogadható értékek:
  • "tm" — előfordítás Fordítási memóriával
  • "mt" — előfordítás Gépi fordításokkal. Az engine paraméterrel kell használni.
Fordítási memória használata az alapértelmezett.
engine opcionális string A Gépi fordítás motorját határozza meg.
Elfogadható értékek:
  • "microsoft" — előfordítás Microsoft Translator segítségével
  • "google" — előfordítás Google Fordítóval
  • "yandex" — előfordítás Yandex.Translate segítségével
Megjegyzés: Győződjön meg arról, hogy a megfelelő kulcsokat beállította a Gépi fordításhoz.
approve_translated opcionális bool Automatikusan jóváhagyja a lefordított karakterláncokat. Elfogadható értékek: 1 vagy 0. Ez csak FM előfordítási módszerrel működik.
auto_approve_option opcionális int Meghatározza, hogy az FM előfordítások során hozzáadott fordítások közül melyek legyenek automatikusan jóváhagyva.
Elfogadható értékek: 0, 1, vagy 2. Az alapértelmezett érték 0.
  • "0" — összes
  • "1" — tökéletes egyezéssel
  • "2" — összes (auto-helyettesített javaslatok kihagyása)
Figyelem: Csak akkor működik, ha az "approve_translated" paraméter értéke 1.
import_duplicates opcionális bool A fordításokat akkor is hozzáadja, ha ugyanaz a fordítás már létezik. Elfogadható értékek: 1 vagy 0. Ez csak FM előfordítási módszerrel működik.
apply_untranslated_strings_only opcionális bool Csak a le nem fordított karakterláncokra vonatkozik. Elfogadható értékek: 1 vagy 0. Ez csak FM előfordítási módszerrel működik.
perfect_match opcionális bool Előfordítás csak azon karakterláncokhoz készül, ahol tökéletes egyezés van a forrásszöveggel és a szövegösszefüggés információkkal. Elfogadható értékek: 1 vagy 0. Ez csak FM előfordítási módszerrel működik.
json opcionális string Nem tartalmazhat értéket. Meghatározza, hogy a válasz JSON formátumban legyen.
jsonp opcionális string Visszahívási függvény neve. Meghatározza, hogy a válasz JSONP formátumban legyen.
Változók
project-identifier string Projekt azonosítója.
login string A felhasználóneve a Crowdinban.
account-key string A fiókja API kulcsa.

Válasz

Ha a módszer sikeres, akkor XML struktúrával válaszol, ahogy az az alábbiakban látható.
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
Ha olyan nyelvet kér, amely nem szerepel a projektben, a válasz így néz ki:
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <languages>
    <language status="skipped">French</language>
  </languages>
</success>
Sikertelen válasz példa:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>API key is not valid</message>
</error>

Példák

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;

Hasznos volt ez a cikk?