Состояние перевода

Отследить общие прогрессы перевода и утверждения для каждого целевого языка. Формат ответа по умолчанию — XML.

Запрос

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

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

Параметры

Название Значение Описание
xml необязательный строка Может не содержать никакого значения. Определяет, что ответ должен быть в формате XML.
json необязательный строка Может не содержать никакого значения. Определяет, что ответ должен быть в формате JSON.
jsonp необязательный строка Имя функции обратного вызова. Определяет, что ответ должен быть в формате JSONP.
Variables
project-identifier обязательный строка Идентификатор проекта.
project-key необязательный строка Ключ API проекта. Требуется либо ключ проекта либо комбинация имя пользователя и ключ аккаунта.
username необязательный строка Ваше имя пользователя в Crowdin. Требуется либо ключ проекта либо комбинация имя пользователя и ключ аккаунта.
account-key необязательный строка API Ключ аккаунта. Требуется либо ключ проекта либо комбинация имя пользователя и ключ аккаунта.

Ответ

В случае успеха этот метод возвращает структуру XML, как показано ниже.
<?xml version="1.0" encoding="ISO-8859-1"?>
<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="ISO-8859-1"?>
<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="ISO-8859-1"?>
<error>
  <code>3</code>
  <message>API key is not valid</message>
</error>

Примеры

curl https://api.crowdin.com/api/project/{project-identifier}/status?key={project-key}&jsonp=mycallback
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/status?key={project-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;

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