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.
Name | Value | Description |
---|---|---|
name optional | string | Project name. |
languages optional | array | An array of language codes a project should be translate to. |
join_policy optional | string | Project join policy. Acceptable values are:
|
language_access_policy optional | string | Defines how project members can access target languages. Acceptable values are:
|
hide_duplicates optional | int | Defines whether duplicated strings should be displayed to translators or should be hidden and translated automatically. Acceptable values are:
|
export_translated_only optional | bool | Defines whether only translated strings will be exported to the final file. We do not recommend to set this option if you have text (*.html, *.txt, *.docx etc.) documents in your project since it may damage resulted files. Acceptable values are: 1 or 0. |
export_approved_only optional | bool | If set to 1 only approved translations will be exported in resulted ZIP file. Acceptable values are: 1 or 0. |
auto_translate_dialects optional | bool | Untranslated strings of dialect will be translated automatically in exported file, leveraging translations from main language. Acceptable values are: 1 or 0. |
public_downloads optional | bool | Defines whether "Download" button visible to everyone on Crowdin webpages. Acceptable values are: 1 or 0. |
use_global_tm optional | bool | Defines if translations would be leveraged from Crowdin Global Translation Memory. When using this option any translations made in your project will be commited to Crowdin Global TM automatically. Acceptable values are: 1 or 0. |
logo optional | file | Project logo at Crowdin. |
cname optional | string | Custom domain name for Crowdin project. |
description optional | string | Project description. |
qa_checks optional | array | Defines whether the QA checks should be active in the project. As a key you must specify QA check parameter (An Overview of QA Check Parameters). Possible keys are:
Note! This option is available only for organization plans. |
webhook_file_translated optional | string | Open this URL when one of the project files is translated. URL will be opened with "project" - project identifier, "language" - language code and "file" - file name. |
webhook_file_proofread optional | string | Open this URL when one of the project files is proofread. URL will be opened with "project" - project identifier, "language" - language code and "file" - file name. |
webhook_project_translated optional | string | Open this URL when project translation is complete. URL will be opened with "project" - project identifier and "language" - language code. |
webhook_project_proofread optional | string | Open this URL when project proofreading is complete. URL will be opened with "project" - project identifier and "language" - language code. |
json optional | string | May not contain value. Defines that response should be in JSON format. |
jsonp optional | string | Callback function name. Defines that response should be in JSONP format. |
Variables | ||
project-identifier | string | Project identifier. |
login | string | Your username in Crowdin. |
account-key | string | Your account API key. |
<?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>
<?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>
<?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?login={username}&account-key={account-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/edit-project?login={username}&account-key={account-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;