Статус перекладу

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
Відстежувати загальний прогрес перекладу і коректури з кожної цільової мови. Зумовлений формат відповіді - XML.

Запит

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}/status?login={username}&account-key={account-key}

Параметри

Ім'я Значення Опис
languages необов'язковий масив Відстежуйте загальний прогрес перекладу і коректури для певних цільових мов. Для цього використовуйте Коди мов Сrowdin.
xml необов'язково рядок Може не містити значення. Визначає те, що відповідь повинна бути в форматі XML.
json необов'язковий рядок Може не містити значення. Визначає, що відповідь має бути в форматі JSON.
jsonp необов'язковий рядок Назва функції зворотного виклику. Визначає, що відповідь має бути в форматі JSONP.
Variables
project-identifier рядок Ідентифікатор проекту.
login рядок Ваше ім'я користувача в Crowdin.
account-key рядок API ключ вашого облікового запису.

Відповідь

Якщо метод успішний, він повертає XML-структуру, як показано нижче.
<?xml version="1.0" encoding="UTF-8"?>
<status>
  <language>
    <name>French</name>
    <code>fr</code>
    <phrases>20</phrases>
    <translated>10</translated>
    <approved>5</approved>
    <words>50</words>
    <words_translated>35</words_translated>
    <words_approved>15</words_approved>
    <translated_progress>50</translated_progress>
    <approved_progress>25</approved_progress>
  </language>
  <language>
    <name>Romanian</name>
    <code>ro</code>
    <phrases>20</phrases>
    <translated>0</translated>
    <approved>0</approved>
    <words>50</words>
    <words_translated>35</words_translated>
    <words_approved>15</words_approved>
    <translated_progress>0</translated_progress>
    <approved_progress>0</approved_progress>
  </language>
  <!-- ............each project language............-->
</status>
Якщо включена Перевірка КЯ, цей метод повертає наступну XML-структуру:
<?xml version="1.0" encoding="UTF-8"?>
<status>
  <language>
    <name>French</name>
    <code>fr</code>
    <phrases>20</phrases>
    <translated>10</translated>
    <approved>5</approved>
    <words>50</words>
    <words_translated>35</words_translated>
    <words_approved>15</words_approved>
    <translated_progress>50</translated_progress>
    <approved_progress>25</approved_progress>
    <qa_issues>10</qa_issues>
  </language>
  <!-- ............each project language............-->
</status>
Приклад невдалого запиту:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>Ключ API недійсний</message>
</error>

Приклади

curl https://api.crowdin.com/api/project/{project-identifier}/status?login={username}&account-key={account-key}&jsonp=mycallback
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/status?login={username}&account-key={account-key}&xml';

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

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

echo $result;

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