Præoversættelse

Præoversætte Crowdin projekt-filer.

Forespørgsel

Bemærk: Benyt enten kombinationen af projektidentifikator og projektnøgle eller en kombination af projektidentifikator, brugernavn, og kontonøgle at videregive til dette endepunkt.

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}

Parametre

Navn Parameter Beskriveslse
languages obligatorisk matrix Sprogsæt, hvortil præoversættelse skal anvendes. Benyt Сrowdin-sprogkoder til dette.
files obligatorisk matrix Filmatrixer, som skal oversættes. Matrixnøgler skal indeholde filnavne inkl. sti i Crowdin-projektet.
method valgfrit string Definerer dén metode, der vil blive benyttet til præoversættelse.
Gyldige værdier er:
  • "tm" — Præoversættelse via Translation Memory
  • "mt" — Præoversættelse via Maskinoversættelse. Skal benyttes med paramereren motor.
Oversættelseshukommelse i brug som standard.
engine valgfrit string Definerer motor til Maskinoversættelse.
Gyldige værdier er:
  • "microsoft" — Præoversættelse via Microsoft Translator
  • "google" — Præoversættelse via Google Translate
  • "yandex" — Præoversættelse via Yandex.Translate
Bemærk: Sørg for, at du har angivet de rigtige nøgler til Maskinoversættelse.
approve_translated valgfrit bool Godkender automatisk oversatte strenge. Gyldige værdier er: 1 eller 0. Fungerer kun med TM-præoversættelsesmetoden.
auto_approve_option valgfrit int Definerer, hvilke oversættelser tilføjet af præoversættelse via TM, som skal auto-godkendes.
Gyldige værdier er 0, 1 eller 2. Standardværdien er 0.
  • "0" — alle
  • "1" — med perfekt match
  • "2" — alle (overspring auto-udskiftede forslag)
Bemærk: Fungerer kun, når parameteren "approve_translated" benyttes med værdien 1.
import_duplicates valgfrit bool Tilføjer oversættelser, selv hvis en identisk oversættelse allerede findes. Gyldige værdier er: 1 eller 0. Fungerer kun med TM-præoversættelsesmetoden.
apply_untranslated_strings_only valgfrit bool Anvender kun oversættelser til uoversatte strenge. Gyldige værdier er: 1 eller 0. Fungerer kun med TM-præoversættelsesmetoden.
perfect_match valgfrit bool Præoversættelse anvendes kun for de strenge, som har absolut match i kildetekst og kontekstoplysninger. Gyldige værdier: 1 eller 0. Fungerer kun med TM-præoversættelsesmetoden.
json valgfri string Må ikke indeholde numerisk værdi. Definerer, at svaret skal være i JSON-format.
jsonp valgfri string Tilbagekaldsfunktionsnavn. Definerer, at svaret bør være i JSONP-formatet.
Variabler
project-identifier string Projektidentifikator.
project-key string Projekt API-nøgle. Enten projektnøglen eller en kombination af login og kontonøgle er obligatorisk.
login string Dit Crowdin-brugernavn. Enten projektnøglen eller en kombination af login og kontonøgle er obligatorisk.
account-key string Din konto API-nøgle. Enten projektnøglen eller en kombination af login og kontonøgle er obligatorisk.

Svar

Lykkes metoden, returnerer den en XML-struktur som vist nedenfor:
<?xml version=".0" encoding="ISO-8-1"?>
<success>
</success>
Anmodes om sprog, som ikke er inkluderet i dit projekt, ser returmeddelelsen således ud:
<?xml version=".0" encoding="ISO-8-1"?>
<success>
  <languages>
    <language status="skipped">French</language>
  </languages>
</success>
Returmeddelelseseksempel, hvis mislykket:
<?xml version=".0" encoding="ISO-8-1"?>
<error>
  <code>3</code>
  <message>API-nøgle er ugyldig</message>
</error>

Eksempler

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;

Var denne artikel nyttig?