Экспортировать файл

Этот метод экспортирует один файл перевода из Crowdin. Также, он может быть применен для экспорта XLIFF файлов для автономного перевода.

Запрос

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

GET https://api.crowdin.com/api/project/{идентификатор-проекта}/export-file?key={ключ-проекта}
GET https://api.crowdin.com/api/project/{project-identifier}/export-file?login={username}&account-key={account-key}
Примечание: Экспортируя файлы из Crowdin, вы получите Etag идентификатор в заголовке ответа. Сохраните этот идентификатор, чтобы вы могли использовать его при следующем экспорте файлов. Добавьте идентификатор Etag к Заголовку запроса if-None-Match, чтобы увидеть, были ли какие-либо изменения применены к файлу. В случае изменения файла он будет загружен. Если нет, вы получите код состояния 304 (не изменен).

Параметры

Название Значение Описание
key обязательный строка API-ключ проекта
project-identifier обязательный строка Должен содержать идентификатор проекта.
file обязательный строка Этот параметр указывает путь к файлу, который нужно экспортировать из проекта.
language обязательный строка языковой код Crowdin.
branch необязательный строка Имя ветви связанной версии ( Управления версиями) ).
format необязательный строка Укажите xliff для экспорта файла в XLIFF формат.
export_translated_only необязательный булево Определяет, будут ли экспортированы только переведенные строки в конечный файл. Мы не рекомендуем устанавливать эту опцию, если в вашем проекте есть текстовые (*.html, *.txt, *.docx и т. п.) документы, поскольку они могут стать причиной повреждения итоговых файлов. Допустимые значения: 1 или 0.
export_approved_only необязательный булево Если установлено значение 1, в полученный файл будут экспортированы только утвержденные переводы. Допустимые значения: 1 или 0.

Примеры

#Скачать файл в том же формате что исходный файл
wget -O de.xml "https://api.crowdin.com/api/project/{идентификатор-проекта}/export-file?file=en.xml&language=de&key={ключ-проекта}"

#Скачать файл для перевода оффлайн в формате XLIFF
wget -O de.xliff "https://api.crowdin.com/api/project/{идентификатор-проекта}/export-file?file=en.html&format=xliff&language=de&key={ключ-проекта}"
<?php
ini_set('auto_detect_line_endings', 1);
ini_set('default_socket_timeout', 5); // socket timeout, just in case

file_put_contents('it.xliff', file_get_contents('https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.html&format=xliff&language=de&key={project-key}'));

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