Exportar Relatórios de Custos de Tradução

Gerar receber de Custos de Tradução para calcular o custo real da tradução e saber quanto os teus tradutores e revisores devem receber.

Pedido

Note: Use the combination of project identifier, username, and account key to pass to this endpoint.

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 optional string Defines the report unit. Acceptable values are: 'strings', 'words' (by default), 'chars', 'chars_with_spaces'.
mode optional string Defines the report mode. Acceptable values are: 'simple' (by default), 'fuzzy'.
date_from optional data Strings added from. Use the following ISO 8601 format: YYYY-MM-DD±hh:mm
date_to optional data Strings added to. Use the following ISO 8601 format: YYYY-MM-DD±hh:mm
regular_rates optional 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 optional array Defines individual rates for the specified languages in the specified categories. Each item must contain the language and the rate parameters. The possible rate categories are the same as for the 'regular_rates' parameter.
currency optional string Defines the currency for which the whole report is generated. Acceptable values are: '$' (by default), '€', '¥', '£', 'A$', 'C$', 'Fr', 'CN¥', 'kr', 'NZ$', 'MX$', 'S$', 'HK$', 'kr', '₩', '₺', '₽', '₹', 'R$', 'R'.
format optional string Defines the export file format. Acceptable values are 'csv' and 'xlsx' (by default).
role_based_costs opcional bool Define se os custos devem ser calculados com base nas contribuições ou no papel no projeto. Os valores possíveis são 0 ou 1. 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. O que significa que todas as traduções e aprovações feitas serão exibidas, mas os custos para traduções são calculados apenas para tradutores, custos para aprovações - somente para revisores.
Nota: contribuições dos membros do projeto que estão, atualmente, bloqueadas, ou sem acesso ao idioma também serão listadas, mas não incluídas no custo.
group_by opcional string Agrupar dados por 'utilizador' (padrão) ou por 'idioma'.
json opcional string May contain no value. Defines that the response should be in a JSON format.
jsonp opcional string Nome da função de retorno de chamada. Defines that the response should be in a JSONP format.
Variáveis
project-identifier string Identificador do projeto.
login string O teu nome de utilizador no Crowdin.
account-key string A tua chave API de conta.

Resposta

If the method is successful it responds with an XML structure, as it is shown below.
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <hash>x27bae8588c6904fe33b494fc3b3b8d40</hash>
</success>
Exemplo de resposta mal-sucedida:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>A chave 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?