Előfordítás

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

Kérelem

Figyelem: Vagy a projekt kulcs vagy a felhasználónév és a fiók kulcs kombinációja adható át ehhez a végponthoz. Projekt azonosítója mindkét esetben átadásra kerül.

POST https://api.crowdin.com/api/project/{project-identifier}/pre-translate?key={project-key}
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
Figyelem: Ellenőrizze, 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. 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. Csak FM előfordítási módszerrel működik.
perfect_match opcionális bool Az előfordítás csak azokra a karakterláncokra történik, amelyek tökéletes egyezést mutatnak a forrásszöveggel és a szövegösszefüggés információkkal. Elfogadható értékek: 1 vagy 0. 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 kell legyen.
jsonp opcionális string Visszahívási funkció neve. Meghatározza, hogy a válasz JSONP formátumban legyen.
Változók
project-identifier szükséges string Projekt azonosítója.
project-key opcionális string Projekt API kulcs. Vagy a projekt kulcs vagy a felhasználónév és fiók kulcs kombinációja szükséges.
username opcionális string A felhasználóneve a Crowdinban. Vagy a projekt kulcs vagy a felhasználónév és fiók kulcs kombinációja szükséges.
account-key opcionális string Fiók API kulcs. Vagy a projekt kulcs vagy a felhasználónév és fiók kulcs kombinációja szükséges.

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="ISO-8859-1"?>
<success>
</success>
Ha olyan nyelvet kér, amely nem szerepel a projektben, a válasz így néz ki: 
<?xml version="1.0" encoding="ISO-8859-1"?>
<success>
  <languages>
    <language status="skipped">French</language>
  </languages>
</success>
Sikertelen válasz példa: 
<?xml version="1.0" encoding="ISO-8859-1"?>
<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?key={project-key}
<?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;

Hasznos volt ez a cikk?