Pre-Tradução

Pré-traduza os arquivos do projeto Crowdin.

Pedido

Nota: Ou use a combinação de identificador de projeto e chave do projeto ou combinação de identificador de projeto, nome do usuário, e chave da conta para passar para este ponto final.

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}

Parâmetros

Nome Valor Descrição
languages obrigatório array Conjunto de idiomas para os quais a pré-tradução deve ser aplicada. Para isso use Códigos de idioma do Сrowdin.
files obrigatório array Matriz de arquivos que deve ser traduzida. As chaves de matriz devem conter nomes de arquivos com caminho no projeto no Crowdin.
method opcional string Define qual método será usado para a pré-tradução.
Valores aceitáveis são:
  • "tm" — Pré-tradução via Memória de Tradução
  • "mt" — Pré-tradução via tradução automática. Deve ser usado com o parâmetro engine<0>.
Memória de tradução é usada por padrão.
engine opcional string Define o mecanismo para tradução automática.
Valores aceitáveis são:
  • "microsoft" — Tradução Prévia via Microsoft Translator
  • "google" — Pré-tradução via Google Tradutor
  • "yandex" — Tradução prévia via Yandex.Translate
Nota: Certifique-se de ter definido chaves apropriadas para a Tradução Automática.
approve_translated opcional bool Aprova automaticamente cadeias traduzidas. Os valores aceitáveis são: 1 ou 0. Funciona apenas com o método de pré-tradução da TM.
auto_approve_option opcional int Define quais traduções adicionadas pela pré-tradução via TM devem ser aprovadas automaticamente.
Valores aceitáveis são 0, 1 ou 2. O valor padrão é 0.
  • "0" — todos
  • "1" — com par perfeito
  • "2" — all (ignorar sugestões auto-substituídas)
Nota:Funciona somente quando o parâmetro "approve_translated" é usado com o valor 1.
import_duplicates opcional bool Adiciona traduções, mesmo que a mesma tradução já exista. Os valores aceitáveis são: 1 ou 0. Funciona apenas com o método de pré-tradução da TM.
apply_untranslated_strings_only opcional bool Aplica traduções apenas para strings não traduzidas. Os valores aceitáveis são: 1 ou 0. Funciona apenas com o método de pré-tradução da TM.
perfect_match opcional bool Pré-traduzir será aplicada apenas para as sequências de caracteres, que tem a absoluta correspondência no texto-fonte e informações contextuais. Os valores aceitáveis são: 1 ou 0. Funciona apenas com o método de pré-tradução da TM.
json opcional string Pode não conter valor. Define que a resposta deve estar no formato JSON.
jsonp opcional string Nome da função de retorno de chamada. Define que a resposta deve estar no formato JSONP.
Variáveis
project-identifier string Identificador do projeto.
project-key string Chave da API do projeto. Tanto a chave do projeto ou a combinação de entrada e chave da conta é requerido.
iniciar sessão string Seu nome de usuário no Crowdin. Tanto a chave do projeto ou a combinação de entrada e chave da conta é requerido.
account-key string Sua chave da API da conta. Tanto a chave do projeto ou a combinação de entrada e chave da conta é requerido.

Resposta

Se o método for bem-sucedido, ele responderá com uma estrutura XML, conforme mostrado abaixo.
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
Se você solicitar idiomas que não estão incluídos em seu projeto, a resposta será:
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <languages>
    <language status="skipped">French</language>
  </languages>
</success>
Amostra de resposta mal-sucedida:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>A chave da API não é válida</message>
</error>

Exemplos

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;

Este artigo foi útil?