Експорт файлу

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. Крім того, він може бути застосований для експорту XLIFF-файлів для локалізації оффлайн.

Запит

Note: Use the combination of project identifier, username, and account key to pass to this endpoint.

GET https://api.crowdin.com/api/project/{project-identifier}/export-file?login={username}&account-key={account-key}
Увага:Під час експорту файлів з Crowdin, ви отримаєте в заголовку відповіді ідентифікатор Etag. Зберігайте цей ідентифікатор, щоб ви могли використовувати його при подальшому експорті файлів. Додайте ідентифікатор Etag в заголовок запиту If-None-Match, щоб подивитися, чи були внесені зміни в файл. Якщо файл був змінений, він буде завантажений. Якщо - ні, ви отримаєте код статусу 304 (без змін).

Параметри

Ім'я Значення Опис
file обов'язковий рядок Цей параметр вказує шлях до файлу, який потрібно експортувати з проекту.
language обов'язково рядок мовний код Crowdin.
branch необов'язковий рядок Ім'я гілки пов'язаної версії (Управління версіями).
format необов'язковий рядок Вкажіть xliff для експорту файлу в XLIFF формат.
export_translated_only необов'язковий bool Використовуйте цю опцію, якщо ви хочете включити в експортований файл лише перекладені рядки. Ми не рекомендуємо встановлювати цю опцію, якщо у вашому проекті є текстові (*.html, *.txt, *.docx тощо) документи, оскільки це може пошкодити отримані файли. Доступні значення: 1 або 0.
export_translated_files_only необов'язковий bool Використовуйте цю опцію, якщо потрібно експортувати лише перекладені файли. Доступні значення: 1 або 0.
export_approved_only необов'язковий bool Якщо встановлено 1, у файл результатів буде експортовано лише затверджені переклади. Доступні значення: 1 або 0.
Variables
project-identifier рядок Ідентифікатор проекту.
login рядок Ваше ім'я користувача в Crowdin.
account-key рядок API ключ вашого облікового запису.

Приклади

#Download file in the same file format as source
wget -O de.xml "https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.xml&language=de&login={username}&account-key={account-key}"

#Download file for offline translation in XLIFF file format
wget -O de.xliff "https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.html&format=xliff&language=de&login={username}&account-key={account-key}"
<?php
ini_set('default_socket_timeout', 5); // socket timeout, just in case

$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.html&format=xliff&language=de&login={username}&account-key={account-key}';

$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;

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