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.
Føj ny fil til Crowdin-projektet.
Navn | Parameter | Beskrivelse |
---|---|---|
files obligatorisk | matrix | Filmatrix, der skal føjes til projektet. Matrixnøgler skal indeholde filnavne inkl. en sti til Crowdin-projektet. Bemærk! Maks. 20 filer kan uploades pr. filoverførselssession. Den maks. individuelle filstørrelse er 100 MB. |
titler valgfrit | matrix | Et strengematrix definerende titler for uploadede filer. Matrixnøgler skal indeholde filnavne inkl. en sti til Crowdin-projektet. |
export_patterns valgfrit | matrix | Et strengematrix definerende navne på resulterende filer (oversatte filer i det resulterende arkiv). Matrixnøgler skal indeholde filnavne inkl. en sti til Crowdin-projektet. |
type valgfrit | string | Gyldige værdier er:
|
first_line_contains_header Kun CSV-, XLS- og XLSX-filer valgfrit | string | Benyttes ved upload af CSV- (eller XLS-/XLSX-) filer via en API. Angiver, hvorvidt første linje skal importeres, eller indeholder kolonneoverskrifterne. Kan være uden værdiindhold. |
import_translations Kun flersprogede CSV-, XLS- og XLSX-filer valgfrit | integer | Benyttes ved upload af CSV- (eller XLS-/XLSX-) filer via en API. Definerer, hvorvidt der under filimporten også importeres oversættelser – 1, eller oversættelser importeres ikke – 0. Standard: 1. |
scheme Kun CSV-/XLS-/XLSX-filer obligatorisk | string | Bemærk: Benyttes kun ved upload af CSV-/XLS-/XLSX-filer til definering af datakolonnerkortlægning. Gyldig parametre er kombinationen af flg. konstanter:
Bemærk: For at den eksporterede fil skal indeholde oversættelser til alle måksprog, specificér da sprogkode i ordning (f.eks. &scheme=identifier,source_phrase,uk,ruc,fr). |
branch valgfrit | string | Navnet på den relaterede versiongren (Versionshåndtering). |
json valgfri | string | Kan være uden værdiindhold. Definerer, at svar skal være i JSON-formatet. |
jsonp valgfri | string | Returkaldsfunktionsnavn. Definerer, at svar skal være i JSONP-formatet. |
translate_content Kun XML-filer valgfrit | bool | Definerer, om tekster placeret mellem tags skal oversættes. Gyldige værdier er: 0 eller 1. Standard er 1. |
translate_attributes Kun XML-filer valgfrit | bool | Definerer, om tags-attributter skal oversættes. Gyldige værdier er: 0 eller 1. Standard er 1. |
content_segmentation Kun XML-filer valgfrit | bool | Definerer, om lange tekster skal opdeles i kortere tekstsegmenter. Gyldige værdier er: 0 eller 1. Standard er 1. Vigtigt! Denne indstilling umuliggør upload af eksisterende oversættelser til XML-filer, når den er aktiveret. |
translatable_elements Kun XML-filer valgfrit | matrix | Dette er en matrix af strenge, hvori hvert element er XPaths tilet DOM-element, der skal importeres. Gyldige værdier er:
Bemærk: Såfremt defineret, tages parametrene "translate_content" og "translate_attributes" ikke i betragtning under import. |
escape_quotes kun egenskabsfiler valgfrit | integer | Definerer, om et enkelt anførselstegn skal escapes af et andet enkelt anførselstegn eller bagudvendt stråstreg i eksporterede oversættelser. Gyldige værdier er: 0, 1, 2, 3. Standard er 3. 0 — Escape ikke enkeltstående anførselstegn; 1 — Escape enkeltstående anførselstegn med andet anførselstegn; 2 — Escape enkeltstående anførselstegn med bagudvendt skråstrg; 3 — Escape kun enkeltstående anførselstegn med andet enkeltstående anførselstegn i strenge indeholdende variabler ( {0} ) |
Variabler | ||
project-identifier | string | Projektidentifikator. |
login | string | Dit brugernavn i Crowdin. |
account-key | string | Din konto API-nøgle. |
<?xml version="1.0" encoding="UTF-8"?>
<success>
<stats>
<file file_id="342">
<name>strings.xml</name>
<strings>4</strings>
<words>11</words>
</file>
</stats>
</success>
<?xml version="1.0" encoding="UTF-8"?>
<error>
<code>3</code>
<message>API-nøgle er ugyldig</message>
</error>
curl \
-F "files[/directory/arrays.xml]=@arrays.xml" \
-F "files[strings.xml]=@strings.xml" \
https://api.crowdin.com/api/project/{project-identifier}/add-file?login={username}&account-key={account-key}
curl \
-F "files[directory/multilingual.csv]=@example.csv" \
-F "export_patterns[directory/multilingual.csv]=/%locale%/%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}/add-file?login={username}&account-key={account-key}
<?php
$post_params = array();
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/add-file?login={username}&account-key={account-key}';
if (function_exists('curl_file_create')) {
$post_params['files[test.txt]'] = curl_file_create('/home/crowdin/test.txt');
} else {
$post_params['files[test.txt]'] = '@/home/crowdin/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}/add-file?login={username}&account-key={account-key}';
if(function_exists('curl_file_create')) {
$post_params['files[directory/multilingual.csv]'] = curl_file_create('/home/crowdin/example.csv');
} else {
$post_params['files[directory/multilingual.csv]'] = '@/home/crowdin/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;