Para gerentes de projeto

Para tradutores

Para desenvolvedores

Métodos da API

Empresa

Pre-Tradução

Pré-traduza os arquivos do projeto Crowdin.

Pedido

Nota: Use a combinação de identificador do projeto e chave do projeto ou a combinação do identificador do projeto, nome de 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 este uso de 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 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 parâmetro engine.
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 frases 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.
Os 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 frases 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 A pré-tradução será aplicada apenas para as frases que tiverem correspondência absoluta no texto-fonte e nas 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 Não pode conter nenhum 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 Chave da API da sua 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?