Экспорт отчета об оценке затрат

Please consider that API 2.0 is now the preferred version to be used. The old API will remain fully functional until the end of 2021.

Crowdin API v2
Сгенерируйте отчет об оценке затрат, чтобы понять, как планировать бюджет. Этот отчет позволяет рассчитать приблизительную стоимость перевода непереведенных на текущий момент строк в проекте.

Запрос

Примечание: Используйте комбинацию идентификатора проекта; имени пользователя, и ключа учетной записи, чтобы перейти в эту конечную точку.

POST https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?login={username}&account-key={account-key}

Параметры

Название Значение Описание
unit необязательный строка Определяет единицу отчета. Допустимые значения: 'strings', 'words' (по умолчанию), 'chars', 'chars_with_spaces'.
mode необязательный строка Определяет режим отчета. Допустимые значения: 'простой' (по умолчанию), 'неточный'.
calculate_internal_fuzzy_matches необязательный булево Доступно только для режима неточного соответствия. Считает все внутренние совпадения, чтобы проверить, сколько строк можно добавить в TM, если строки переведены одна за другой, как указано в списке. Имейте в виду, что вычисления приблизительны, потому что строки могут быть переведены в другом порядке. Допустимые значения: 1 или 0.
language обязательный строка Язык, для которого должен быть создан отчет. Для этого используйте Crowdin коды для языков.
date_from необязательный дата Строки добавлены. Используйте следующий формат даты ISO 8601: ГГГГГ-ММ-ДД±ччч:мм
date_to необязательный дата Строки добавлены. Используйте следующий формат даты ISO 8601: ГГГГГ-ММ-ДД±ччч:мм
normal_rates необязательный массив Задаёт стандартные тарифы для указанных категорий.
Возможные категории для отчета в простом режиме: «по умолчанию», «tm» и «одобрить».
Возможные категории для отчета в неточном режиме: «одобрить», 'Перевод', 'совершенный', 'сопоставленный' и три настраиваемых диапазона между 60% и 100% (например, 99-90).
individual_rates необязательный массив Определяет индивидуальные тарифы для указанных языков в указанных категориях. Каждый элемент должен содержать язык и параметры тарифа. Возможные типы тарифов такие же, как для параметра 'regular_rates'.
currency необязательный строка Определяет валюту, для которой создается весь отчет. Допустимые значения: «$» (по умолчанию), «€», «¥», «£», «A $», «C $», «Fr», «CN ¥», «kr», «NZ $ ',' MX $ ',' S $ ',' HK $ ',' kr ',' ₩ ',' ₺ ',' ₽ ',' ₹ ',' R $ ',' R '.
format необязательный строка Определяет формат экспортируемого файла Допустимые значения: 'csv' и 'xlsx' (по умолчанию).
json необязательный строка Может не содержать значения. Определяет, что ответ должен быть в формате JSON.
jsonp необязательный строка Название функции обратного вызова. Определяет, что ответ должен быть в формате JSONP.
Variables
project-identifier строка Идентификатор проекта.
login строка Ваше имя пользователя в Crowdin.
account-key строка API ключ вашего аккаунта.

Ответ

Если метод успешен, он реагирует со структурой XML, как показано ниже.
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <hash>x1ff24323a2f6058382b31fbc237bcd74</hash>
</success>
Образец ответа при неудавшемся запросе:
<?xml version=".0" encoding="ISO-8-1"?>
<error>
  <code>3</code>
  <message>API key is not valid</message>
</error>

Примеры

  curl \
    -F "unit=chars" \
    -F "mode=simple" \
    -F "format=csv" \
    -F "language=uk" \
    -F "date_from=2017-01-01" \
    -F "date_to=2017-01-03" \
    -F "regular_rates[default]=1.05" \
    -F "regular_rates[tm]=1.00" \
    -F "regular_rates[approval]=2.00" \
    https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?login={username}&account-key={account-key}
  
  curl \
    -F "unit=words" \
    -F "mode=fuzzy" \
    -F "format=xlsx" \
    -F "language=uk" \
    -F "date_from=2017-06-05+0200" \
    -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/costs-estimation/export?login={username}&account-key={account-key}
  
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/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;

Была ли эта статья полезной?