Загрузить термины в проект

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
Загрузить свои термины для проекта Crowdin в форматах файлов TBX, CSV или XLS/XLSX.

Запрос

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

Параметры

Название Значение Описание
file обязательный файл Файл в формате TBX, CSV или XLS/XLSX.
first_line_contains_header Только файлы CSV и XLS/XLSX
необязательный
строка Используется при загрузке CSV (или XLS/XLSX) файлы через API. Defines whether first line should be imported or it contains columns headers. Может не содержать значения.
scheme Только для файлов CSV и XLS/XLSX
обязательный
строка Примечание: используется только при загрузке CSV (или XLS/XLSX) файла для определения сопоставления столбцов данных.
Приемлемым значением является комбинация следующих констант (%language_code% обозначает код языка):
  • "term_crowdin_language_code" — столбец с терминами.
  • "description_crowdin_language_code" — столбец с объяснениями терминов.
  • «none» - не импортировать столбец.
Пример параметров, которые вам придется добавить: &scheme=term_en,description_en,нет,term_uk,description_uk
json необязательный строка Может не содержать значения. Определяет, что ответ должен быть в формате JSON.
jsonp необязательный строка Название функции обратного вызова. Определяет, что ответ должен быть в формате JSONP.
Variables
project-identifier строка Идентификатор проекта.
login строка Ваше имя пользователя в Crowdin.
account-key строка API ключ вашего аккаунта.

Ответ

If successful, this method returns a XML structure, as it is shown below.
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
Unsuccessful response sample:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>API key is not valid</message>
</error>

Примеры

curl \
  -F "file=@glossary.tbx" \
  https://api.crowdin.com/api/project/{project-identifier}/upload-glossary?login={username}&account-key={account-key}
curl \
  -F "file=@glossary.csv" \
  -F "first_line_contains_header=true" \
  -F "scheme=term_en,description_en,none,term_uk,description_uk" \
  https://api.crowdin.com/api/project/{project-identifier}/upload-glossary?login={username}&account-key={account-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/upload-glossary?login={username}&account-key={account-key}';

if(function_exists('curl_file_create')) {
  $post_params['file'] = curl_file_create('/home/crowdin/test.tbx');
} else {
  $post_params['file'] = '@/home/crowdin/test.tbx';
}

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

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

echo $result;

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