Завантажити терміни в проект

Завантажити свої терміни для проекту Crowdin в форматах файлів TBX, CSV або XLS / XLSX.

Запит

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

POST https://api.crowdin.com/api/project/{ідентифікатор-проекту}/upload-glossary?key={ключ-проекту}
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. Визначає, чи потрібно імпортувати перший рядок і чи містить він заголовки стовпців. Може не містити значення.
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 рядок Ідентифікатор проекту.
project-key рядок API-ключ проекту. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.
login рядок Ваше ім'я користувача в Crowdin. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.
account-key рядок API ключ вашого облікового запису. Потрібно або ключ проекту, або комбінація ім'я користувача і ключ акаунта.

Відповідь

Якщо метод успішний, він повертає XML-структуру, як показано нижче.
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
Приклад невдалого запиту:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>Ключ API недійсний</message>
</error>

Приклади

curl \
  -F "file=@glossary.tbx" \
  https://api.crowdin.com/api/project/{project-identifier}/upload-glossary?key={project-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?key={project-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/upload-glossary?key={project-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;

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