Bitte beachten Sie, dass API 2.0 jetzt die bevorzugte Version ist. Die alte API bleibt bis Ende 2021 voll funktionsfähig.
Name | Wert | Beschreibung |
---|---|---|
files benötigt | Array | Files array that should be updated. Hinweis! Pro Dateiübertragung können nur maximal 20 Dateien gleichzeitig hochgeladen werden. |
titles optional | Array | An arrays of strings that defines titles for uploaded files. Die Array-Schlüssel müssen den Dateinamen mit dem Pfad im Crowdin-Projekt beinhalten. |
export_patterns optional | Array | An arrays of strings that defines names of resulted files (translated files in resulted archive). Die Array-Schlüssel müssen den Dateinamen mit dem Pfad im Crowdin-Projekt beinhalten. |
new_names optional | Array | An arrays of strings that defines new names for previously imported files. Die Array-Schlüssel müssen den Dateinamen mit dem Pfad im Crowdin-Projekt beinhalten. |
first_line_contains_header nur CSV- und XLS- bzw. XLSX-Dateien optional | String | Used when uploading CSV (or XLS/XLSX) files via API. Defines whether first line should be imported or it contains columns headers. Könnte keinen Wert enthalten. |
scheme CSV and XLS/XLSX files only required | String | Note: Used only when uploading CSV (or XLS/XLSX) file to define data columns mapping. Acceptable value is the combination of the following constants:
Note: for exported file to contain translations to all the target languages, specify language codes in scheme (e.g. &scheme=identifier,source_phrase,uk,ru,fr). |
update_option optional | String | Depending on the value, "update_option" is used to preserve translations and preserve/remove validations of changed strings during file update. The values are:
|
branch optional | String | Der Name des dazugehörigen Versionszweiges (Versionsverwaltung). |
json optional | String | Könnte keinen Wert enthalten. Definiert, dass die Antwort im JSON-Format sein soll. |
jsonp optional | String | Name der Rückruffunktion. Definiert, dass die Antwort im JSONP-Format sein soll. |
escape_quotes properties files only optional | Integer | Defines whether single quote should be escaped by another single quote or backslash in exported translations. Zulässige Werte sind: „0”, „1”, „2” und „3”. Der Standardwert ist 3. 0 — Do not escape single quote; 1 — Escape single quote by another single quote; 2 — Escape single quote by backslash; 3 — Escape single quote by another single quote only in strings containing variables ( {0} ) |
Variablen | ||
project-identifier | String | Projekt-ID. |
login | String | Ihr Nutzername auf Crowdin. |
account-key | String | Ihr Konto-API-Schlüssel. |
<?xml version="1.0" encoding="UTF-8"?>
<success>
</success>
<?xml version="1.0" encoding="UTF-8"?>
<error>
<code>3</code>
<message>API key is not valid</message>
</error>
curl \
-F "files[/directory/strings.xml]=@strings.xml" \
https://api.crowdin.com/api/project/{project-identifier}/update-file?login={username}&account-key={account-key}
curl \
-F "files[/directory/android.xml]=@strings.xml" \
-F "new_names[/directory/android.xml]=strings.xml" \
https://api.crowdin.com/api/project/{project-identifier}/update-file?login={username}&account-key={account-key}
curl \
-F "files[directory/multilingual.csv]=@example.csv" \
-F "export_patterns[directory/multilingual.csv]=/translations/%original_file_name%" \
-F "titles[directory/multilingual.csv]=Title in Crowdin Project" \
-F "scheme=identifier,source_phrase,translation" \
-F "first_line_contains_header=true" \
https://api.crowdin.com/api/project/{project-identifier}/update-file?login={username}&account-key={account-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/update-file?login={username}&account-key={account-key}';
if (function_exists('curl_file_create')) {
$post_params['files[test.txt]'] = curl_file_create('/home/user/test.txt');
} else {
$post_params['files[test.txt]'] = '@/home/user/test.txt';
}
$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;
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/update-file?login={username}&account-key={account-key}';
if (function_exists('curl_file_create')) {
$post_params['files[/directory/android.xml]'] = curl_file_create('/home/user/strings.xml');
} else {
$post_params['files[/directory/android.xml]'] = '@/home/user/strings.xml';
}
$post_params['new_names[/directory/android.xml]'] = 'strings.xml';
$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;
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/update-file?login={username}&account-key={account-key}';
if(function_exists('curl_file_create')) {
$post_params['files[directory/multilingual.csv]'] = curl_file_create('/home/user/example.csv');
} else {
$post_params['files[directory/multilingual.csv]'] = '@/home/user/example.csv';
}
$post_params['export_patterns[directory/multilingual.csv]'] = '/translations/%original_file_name%';
$post_params['titles[directory/multilingual.csv]'] = 'Title in Crowdin Project';
$post_params['scheme'] = 'identifier,source_phrase,translation';
$post_params['first_line_contains_header'] = '';
$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;