Редактировать проект

Редактирование Crowdin проекта.

Запрос

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

POST https://api.crowdin.com/api/project/{идентификатор-проекта}/edit-project?key={ключ-проекта}
POST https://api.crowdin.com/api/project/{project-identifier}/edit-project?login={username}&account-key={account-key}

Параметры

Название Значение Описание
name необязательный строка Название проекта.
languages необязательный массив Массив языковых кодов на которые проект должен быть переведен.
join_policy необязательный строка Политика присоединения к проекту. Допустимые значения:
  • open
  • private
language_access_policy необязательный строка Определяет, как участники проекта могут получить доступ к целевым языкам. Допустимые значения:
  • «open» - любой переводчик может получить доступ к любому языку.
  • «moderate» - переводчику должен быть предоставлен доступ к определенному языку.
hide_duplicates необязательный число Определяет, должны ли дублированные строки отображаться переводчикам или должны быть скрыты и переведены автоматически. Допустимые значения:
  • 0: Показывать - переводчики будут переводить каждую строку отдельно
  • 1: Скрыть - для всех дубликатов будет применен один перевод
  • 2: Показывать, но автоматически переводить их
  • 3: Показывать (рекомендуется для версий) - дубликаты будут скрыты только между версиями
export_translated_only необязательный булево Определяет, будут ли экспортированы только переведенные строки в конечный файл. Мы не рекомендуем устанавливать эту опцию, если в вашем проекте есть текстовые (*.html, *.txt, *.docx и т. п.) документы, поскольку они могут стать причиной повреждения итоговых файлов. Допустимые значения: 1 или 0.
export_approved_only необязательный булево Если установлено значение 1, в полученный zip файл будут экспортированы только утвержденные переводы. Допустимые значения: 1 или 0.
auto_translate_dialects необязательный булево Не переведенные строки диалектов будут переведены автоматически в экспортируемых файлах, с использованием переводов с основного языка. Допустимые значения 1 или 0.
public_downloads необязательный булево Определяет, видна ли кнопка «Скачать» всем на веб-страницах Crowdin. Допустимые значения: 1 или 0.
use_global_tm необязательный булево Определяет, будут ли использованы переводы из Глобальной памяти переводов Crowdin. Если эта опцию используется, все переводы вашего проекта будут автоматически переданы в Глобальную память перевода. Допустимые значения: 1 или 0.
logo необязательный файл Логотип проекта на Crowdin.
cname необязательный строка Пользовательское доменное имя для проекта Crowdin.
description необязательный строка Описание проекта.
qa_checks необязательный массив Определяет, должны ли проверки качества быть активными в проекте. В качестве ключа необходимо указать параметр проверки QA (Обзор параметров проверки качества). Возможные ключи:
  • "enabled" - включение или отключения проверки качества
  • "empty" - пустой перевод
  • "size" — проблемы длины
  • "tags" - несоответствие тегов
  • "spaces" - несоответствие пробелов
  • "variables" — несоответствие переменных
  • "punctuation" - несоответствие пунктуации
  • "symbol_register" - несоответствие регистра символов
  • "special_symbols" - несоответствие специальных символов
  • "wrong_translation" - проблемы с «неправильным переводом»
  • "spellcheck" - орфография
  • "icu" - синтаксис ICU
Допустимые значения: 1 или 0.
Заметка! Эта опция доступна только для корпоративных тарифных планов.
webhook_file_translated необязательный строка Откройте этот URL при завершенном переводе одного из файлов проекта. Будет открыт URL с «project» - идентификатором проекта, «language» - языковым кодом и «file» - именем файла.
webhook_file_proofread необязательный строка Откройте этот URL при утвержденном переводе одного из файлов проекта. Будет открыт URL с «project» - идентификатором проекта, «language» - языковым кодом и «file» - именем файла.
webhook_project_translated необязательный строка Откройте этот URL после завершения перевода проекта. Откроется URL с "project" - идентификатором проекта и "language" - языковым кодом.
webhook_project_proofread необязательный строка Откройте этот URL после завершения утверждения проекта. Откроется URL с "project" - идентификатором проекта и "language" - языковым кодом.
json необязательный строка Может не содержать значение. Указывает, что ответ должен быть в формате JSON.
jsonp необязательный строка Имя функции обратного вызова. Определяет, что ответ должен быть в формате JSONP.
Variables
project-identifier строка Идентификатор проекта.
project-key строка Ключ API проекта. Требуется либо ключ проекта, либо комбинация имя пользователя и ключ аккаунта.
login строка Ваше имя пользователя в Crowdin. Требуется либо ключ проекта, либо комбинация имя пользователя и ключ аккаунта.
account-key строка API Ключ аккаунта. Требуется либо ключ проекта, либо комбинация имя пользователя и ключ аккаунта.

Ответ

If the method is successful, it responds with an XML structure, as it is shown below (when language_access_policy = open).
<?xml version="1.0" encoding="UTF-8"?>
<project>
  <success>1</success>
  <invitation>http://translate.example.com/project/test-project-api/invite</invitation>
  <url>http://translate.example.com/project/test-project-api</url>
</project>
Response example for projects with "Moderate" language_access_policy.
<?xml version="1.0" encoding="UTF-8"?>
<project>
  <success>1</success>
  <invitation>
    <item>
      <language>Ukrainian</language>
      <translator>http://translate.example.com/project/test-project-api/invite?d=7585662585d5d32307d3937373</translator>
      <proofreader>http://translate.example.com/project/test-project-api/invite?d=3585k635r4d5d32307d3937373</proofreader>
    </item>
  </invitation>
  <url>https://crowdin.com/project/test-project-api</url>
</project>
Unsuccessful response sample:
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>API key is not valid</message>
</error>

Примеры

curl \
  -F "logo=@logo.png" \
  -F "name=new project name" \
  -F "description=new project description" \
  -F "cname=new.example.com" \
  -F "languages[]=de" \
  -F "languages[]=fr" \
  -F "languages[]=zh-CN" \
  -F "hide_duplicates=1" \
  -F "export_approved_only=0" \
  -F "public_downloads=1" \
  -F "qa_checks[enabled]=1" \
  https://api.crowdin.com/api/project/{project-identifier}/edit-project?key={project-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/edit-project?key={project-key}';
$post_params['name'] = 'new project name';
$post_params['join_policy'] = 'open';
$post_params['languages[0]'] = 'fr';
$post_params['languages[1]'] = 'de';
$post_params['languages[2]'] = 'zh-CN';
$post_params['qa_checks[enabled]'] = 1;

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

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