Por favor, considere que API 2.0 agora é a versão preferida a ser usada. A API antiga permanecerá totalmente funcional até o final de 2021.
Adicione o diretório ao projeto do Crowdin.
Nome | Valor | Descrição |
---|---|---|
files obrigatório | array | Matriz de arquivos que deve ser adicionada ao projeto no Crowdin. As chaves de matriz devem conter nomes de arquivos com caminho no projeto no Crowdin. Nota! Máximo de 20 arquivos podem ser enviados por transferência de arquivos por vez. O tamanho máximo de um arquivo é de 100 MB. |
titles opcional | array | Uma matriz de textos que define títulos para arquivos enviados. As chaves de matriz devem conter nomes de arquivos com caminho no projeto no Crowdin. |
export_patterns opcional | array | Uma matriz de textos de caracteres que define nomes de arquivos resultantes (arquivos traduzidos no arquivo de resultados). As chaves de matriz devem conter nomes de arquivos com caminho no projeto no Crowdin. |
type opcional | string | Valores aceitáveis são:
|
first_line_contains_header Somente arquivos CSV e XLS/XLSX opcional | string | Usado ao fazer o upload de arquivos CSV (ou XLS / XLSX) via API. Define se a primeira linha deve ser importada ou se contém os cabeçalhos das colunas. Pode conter nenhum valor. |
import_translations Somente arquivos multilíngues CSV e XLS/XLSX opcional | inteiro | Usado ao fazer o upload de arquivos CSV (ou XLS / XLSX) via API. Define se, durante o arquivo, as traduções de importação também são importadas - 1, ou as traduções não são importadas - 0. Padrão: 1. |
scheme Somente arquivos CSV e XLS / XLSX obrigatório | string | Nota: Usado somente ao fazer o upload do arquivo CSV (ou XLS / XLSX) para definir o mapeamento de colunas de dados. O valor aceitável é a combinação das seguintes constantes:
Nota: para o arquivo exportado conter traduções em todos os idiomas de destino, especifique language codes in scheme (e.g. &scheme=identifier,source_phrase,uk,ru,fr). |
branch opcional | string | O nome da ramificação da versão relacionada (Gerenciamento de Versões). |
json opcional | string | Pode conter nenhum valor. Define que a resposta deve estar no formato JSON. |
jsonp opcional | string | Nome da função de retorno de chamada. Define que a resposta deve estar no formato JSONP. |
translate_content Apenas arquivos XML opcional | bool | Define se deve traduzir textos colocados dentro das etiquetas. Os valores aceitáveis são: 0 ou 1. O padrão é 1. |
translate_attributes Apenas arquivos XML opcional | bool | Define se deve traduzir atributos de etiquetas. Os valores aceitáveis são: 0 ou 1. O padrão é 1. |
content_segmentation Apenas arquivos XML opcional | bool | Define se os textos longos devem ser divididos em segmentos de textos menores. Os valores aceitáveis são: 0 ou 1. O padrão é 1. Importante! Esta opção desativa a possibilidade de carregar traduções existentes para arquivos XML quando ativada. |
translatable_elements Apenas arquivos XML opcional | array | Este é um array de frases, onde cada item é o XPaths para elemento DOM que deve ser importado. Os valores aceitáveis são:
Nota! Se definido, os parâmetros "translate_content" e "translate_attributes" não são considerados durante a importação. |
escape_quotes somente arquivos de propriedades opcional | inteiro | Define se aspas simples devem ser evitadas por outra aspa simples ou barra invertida nas traduções exportadas. Os valores aceitáveis são: 0, 1, 2, 3. O padrão é 3. 0 — Não escape uma citação; 1 — Escape única citação por outra simples citação; 2 — Escape uma citação da barra invertida; 3 — Escape de aspas simples por outra aspa simples apenas em strings contendo variáveis ( {0} ) |
Variáveis | ||
project-identifier | string | Identificador do projeto. |
iniciar sessão | string | Seu nome de usuário no Crowdin. |
account-key | string | Sua chave da API da conta. |
<?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>A chave da API não é válida</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;