Pre-Traduzione

Sei pregato di considerare che l'API 2.0 è ora la versione preferita da usare. La vecchia API rimarrà pienamente funzionare fino alla fine del 2021.

API di Crowdin v2

Pre-traduci i file del progetto di Crowdin.

Richiesta

Nota: Usa la combinazione di identificatore del progetto, nome utente e chiave del profilo per passare a questo endpoint.

POST https://api.crowdin.com/api/project/{project-identifier}/pre-translate?login={username}&account-key={account-key}

Parametri

Nome Valore Descrizione
lingue obbligatorie insieme Serie di lingue verso cui la pre-traduzione dovrebbe esser applicata. Per questo usa i codici linguistici di Crowdin.
file obbligatori insieme Insieme di file che dovrebbe esser tradotto. Le chiavi dell'insieme dovrebbero contenere i nomi dei file con percorso nel progetto di Crowdin.
metodo opzionale nella stringa Definisce quale metodo sarà usato per la pre-traduzione.
Valori accettabili sono:
  • "tm" — Pre-traduzione tramite Memoria di Traduzione
  • "mt" — Pre-traduzione tramite Traduzione Automatica. Dovrebbe essere usato con il parametro motore.
La Memoria di Traduzione è usata di default.
motore opzionale nella stringa Definisce il motore della Traduzione Automatica.
Valori accettabili sono:
  • "microsoft" — Pre-traduzione tramite Microsoft Translator
  • "google" — Pre-traduzione tramite Google Traduttore
  • "yandex" — Pre-traduzione tramite Yandex.Translate
Nota: Assicurati di aver impostato le chiavi appropriate per la Traduzione Automatica.
approve_translated opzionale booleano Approva automaticamente le stringhe tradotte. Valori accettabili sono: 1 o 0. Funziona solo con il metodo di pre-traduzione della TM.
auto_approve_option opzionale int Definisce quali traduzioni aggiunte via pre-traduzione tramite TM dovrebbero esser approvate automaticamente.
Sono valori accettabili: 0, 1 o 2. Il valore predefinito è 0.
  • "0" — tutte
  • "1" — con corrispondenza perfetta
  • "2" — tutte (salta suggerimenti sostituiti automaticamente)
Nota:Funziona solo quando il parametro "approve_translated" è usato con il valore 1.
import_duplicates opzionale booleano Aggiunge le traduzioni anche se la stessa traduzione esiste già. Valori accettabili sono: 1 o 0. Funziona solo con il metodo di pre-traduzione della TM.
apply_untranslated_strings_only opzionale booleano Applica le traduzioni solo per le stringhe non tradotte. Valori accettabili sono: 1 o 0. Funziona solo con il metodo di pre-traduzione della TM.
perfect_match opzionale booleano La pre-traduzione sarà applicata solo per queste stringhe, aventi una corrispondenza assoluta nel testo di partenza e con le informazioni contestuali. Valori accettabili sono: 1 o 0. Funziona solo con il metodo di pre-traduzione della TM.
json opzionale nella stringa Potrebbe non contenere il valore. Definisce che la risposta dovrebbe essere in formato JSON.
jsonp opzionale nella stringa Nome della funzione di callback. Definisce che la risposta dovrebbe essere in formato JSONP.
Variabili
identificatore-progetto nella stringa Identificatore progetto.
accesso nella stringa Il tuo nome utente su Crowdin.
chiave-profilo nella stringa La chiave API del tuo profilo.

Risposta

Se il metodo funziona risponde con una struttura XML, come mostrato sotto:
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
Se richiedi lingue non incluse nel tuo progetto, la risposta somiglia a questa:
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <languages>
    <language status="skipped">Francese</language>
  </languages>
</success>
Esempio di risposta fallita:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>Chiave API non valida</message>
</error>

Esempi

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;

Questo articolo è stato utile?