Para gerentes de projeto

Para tradutores

Para desenvolvedores

API v1
Webhooks
Endereço de IP

Empresa

Relatório de custos de tradução de exportação

Por favor, considere que API 2.0 agora é a versão preferida a ser usada. A API antiga permanecerá totalmente funcional até o final de 2021.

Crowdin API v2
Gere custos de tradução para calcular o custo real de tradução e saber quanto os tradutores e revisores devem receber.

Pedido

Nota: Use a 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}/reports/translation-costs/export?login={username}&account-key={account-key}

Parâmetros

Nome Valor Descrição
unit opcional string Define a unidade de relatório. Valores aceitáveis são: 'strings', 'words' (por padrão), 'chars', 'chars_with_spaces'.
mode opcional string Define o modo de relatório. Os valores aceitáveis são: 'simple' (por padrão), 'fuzzy'.
date_from opcional date Sequências de caracteres adicionadas de. Use o seguinte formato ISO 8601: YYYY-MM-DD±hh:mm
date_to opcional date Sequências de caracteres adicionadas para. Use o seguinte formato ISO 8601: YYYY-MM-DD±hh:mm
regular_rates opcional array Define as taxas regulares para as categorias especificadas.
Possíveis categorias para um relatório no modo simples são: 'default', 'tm', 'approval'.
Possíveis categorias para um relatório no modo difuso são: 'aproval', 'translation', 'perfect', 'matched' e três faixas personalizadas entre 60% e 100% (por exemplo: 99-90).
individual_rates opcional array Define taxas individuais para os idiomas especificados nas categorias especificadas. Cada item deve conter o idioma e os parâmetros de taxa. As categorias de taxa possíveis são as mesmas do parâmetro 'regular_rates'.
currency opcional string Define a moeda para a qual todo o relatório é gerado. Valores aceitáveis são: '$' (por padrão), '€', '¥', '£', 'A$', 'C$', 'Fr', 'CN¥', 'kr', 'NZ$', 'MX$', 'S$', 'HK$', 'kr', '₩', '₺', '₽', '₹', 'R$', 'R'.
format opcional string Define o formato do arquivo de exportação. Valores aceitáveis são 'csv' e 'xlsx' (por padrão).
role_based_costs opcional bool Define se os custos devem ser calculados com base nas contribuições ou na função do projeto. Os valores possíveis são 0 ou 1. O padrão é 0. O padrão é 0.

0 – os custos serão calculados para todas as traduções e aprovações feitas por cada membro do projeto, independentemente do papel no projeto;
1 – os custos serão calculados com base na função do membro do projeto.
group_by opcional string Agrupar dados por 'usuário' (padrão) ou por 'idioma'.
json opcional string Pode conter nenhum valor. Define que a resposta deve estar em um formato JSON.
jsonp opcional string Nome da função de retorno de chamada. Define que a resposta deve estar em um formato JSONP.
Variáveis
project-identifier string Identificador do projeto.
iniciar sessão string Seu nome de usuário no Crowdin.
account-key string Sua chave da API da conta.

Resposta

Se o método for bem sucedido, ele responde com uma estrutura XML, como é mostrado abaixo. 
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <hash>x27bae8588c6904fe33b494fc3b3b8d40</hash>
</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 "unit=chars" \
  -F "mode=simple" \
  -F "format=csv" \
  -F "regular_rates[default]=1.05" \
  -F "regular_rates[tm]=1.00" \
  -F "regular_rates[approval]=2.00" \
  -F "individual_rates[0][languages][]=uk" \
  -F "individual_rates[0][languages][]=ca" \
  -F "individual_rates[0][languages][]=af" \
  -F "individual_rates[0][languages][]=fr" \
  -F "individual_rates[0][rates][default]=1.40" \
  -F "individual_rates[0][rates][tm]=1.10" \
  -F "individual_rates[0][rates][approval]=2.00" \
  -F "individual_rates[1][languages][]=de" \
  -F "individual_rates[1][rates][default]=1.55" \
  -F "individual_rates[1][rates][tm]=1.20" \
  -F "individual_rates[1][rates][approval]=2.10" \
  https://api.crowdin.com/api/project/{project-identifier}/reports/translation-costs/export?login={username}&account-key={account-key}
curl \
  -F "unit=words" \
  -F "mode=fuzzy" \
  -F "format=xlsx" \
  -F "regular_rates[translation]=2.05" \
  -F "regular_rates[perfect]=1.00" \
  -F "regular_rates[matched]=1.00" \
  -F "regular_rates[99-95]=1.03" \
  -F "regular_rates[94-90]=1.05" \
  -F "regular_rates[89-80]=1.20" \
  -F "regular_rates[approval]=3.00" \
  https://api.crowdin.com/api/project/{project-identifier}/reports/translation-costs/export?login={username}&account-key={account-key}
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/reports/translation-costs/export?mode=words&login={username}&account-key={account-key}&language=uk';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $request_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);

echo $result;

Este artigo foi útil?