Експорт звіту про оцінку витрат

Згенеруйте звіт про оцінку витрат, щоб мати уявлення про те, як планувати бюджет. Цей звіт дозволяє розрахувати приблизну вартість перекладу рядків проекту, які поки що не перекладені.

Запит

Примітка: Або використовуйте комбінацію ідентифікатора проекту ідентифікатора проекту та ключ проекту або комбінацію ідентифікатор проекту, ім'я користувача, та ключ облікового запису щоб перейти до цієї кінцевої точки.

POST https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?key={project-key}
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 необов'язковий рядок Визначає режим звіту. Можливі значення: 'simple' (за замовчуванням), 'fuzzy'.
calculate_internal_fuzzy_matches необов'язковий bool Доступний тільки для нечіткого режиму. Рахує всі внутрішні збіги, щоб перевірити, скільки рядків можна додати в ПП, якщо рядки перекладено один за одним, як зазначено в списку. Майте на увазі, що обчислення приблизні, тому що рядки можуть бути перекладені в іншому порядку. Доступні значення: 1 або 0.
language обов'язково рядок Мова, на яку має бути згенеровано звіт. Для цього використовуйте Коди мов Сrowdin.
date_from необов'язковий дата Дата додавання рядків. Використовується наступний формат дати ISO 8601: YYYY-MM-DD±hh:mm
date_to необов'язковий дата Дата додавання рядків. Використовується наступний формат дати ISO 8601: YYYY-MM-DD±hh:mm
regular_rates необов'язковий масив Визначає звичайні тарифи для зазначеної категорії.
Можливі категорії для звіту в simple-режимі: 'default', 'tm', і 'approval'.
Можливі категорії для звіту в fuzzy-режимі: 'approval', 'translation', 'perfect', 'matched' і три адаптовані діапазони між 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 рядок Ідентифікатор проекту.
project-key рядок API-ключ проекту. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.
login рядок Ваше ім'я користувача в Crowdin. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.
account-key рядок API ключ вашого облікового запису. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.

Відповідь

При успішності методу, відповідь буде містити XML-структуру, як показано нижче.
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <hash>x1ff24323a2f6058382b31fbc237bcd74</hash>
</success>
Приклад невдалого запиту:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>Ключ API недійсний</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?key={project-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?key={project-key}
  
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?mode=words&key={project-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;

Ця стаття була корисною?