Configurar a Integração API
O Crowdin fornece API RESTful com XML ou JSON via HTTP ao usar métodos GET e POST. Listados abaixo são os métodos API disponíveis, que permitem-te criar projetos no Crowdin, adicionar e atualizar ficheiros, transferir traduções ou integrar localização com o teu processo de desenvolvimento.
Adquirir e Usar uma Chave API
To find your project API key you have to login to your Crowdin account. Find the project, open Project Settings page and activate API tab.
Please note that almost all API calls require the Project Identifier (ID). You can find your project identifier right above the API key.
Fazer Pedidos
Para cada pedido API que fizeres, precisarás apresentar a chave de acesso API como o parâmetro URI principal a ser autenticado. Mantém a chave API em segredo! Ela deve ser guardado apenas com a tua palavra-passe normal da conta.
Aqui está um exemplo e um princípio de formação de URI e pedido API.
GET https://api.crowdin.com/api/project/{project-identifier}/download/all.zip?key={project-key}
Typical API call URL looks like this: https://api.crowdin.com/api/project/. First placeholder (keyword in brackets) holds project identifier. API access key is specified as a URI parameter.
Rate Limits
The number of simultaneous API calls per account is 20 requests. If the limit is exceeded, 429 error code will show up with a message: “Maximum number of concurrent requests for this endpoint is reached. Please try again shortly.”
Usar o Postman
Postman é uma ferramenta que permite-te trabalhar com a API do Crowdin duma forma simples.
All the available Crowdin API methods are already saved as a collection in Postman. Click Run in Postman to import and open this collection directly in your Postman app.
Métodos
Adicionar Ficheiro
Add a new file to Crowdin project.
Atualizar Ficheiro
Upload the latest version of your source files (the ones, that should be localized) to your Crowdin project.
Apagar Ficheiro
Delete file from Crowdin project. All the translations will be lost without ability to restore them.
Enviar Tradução
Enviar traduções existentes para o teu projeto no Crowdin. Method is not working for Assets localization.
Estado da Tradução
Track overall translation and proofreading progresses of each target language. Default response format is XML.
Estado do Idioma
Obtenha o progresso detalhado da tradução para o idioma especificado.
Detalhes do Projeto
Obter detalhes do Projeto do Crowdin.
Problemas Reportados
Get a list of issues reported in the Editor.
Exportar Ficheiro
This method exports single translated files from Crowdin. Additionally, it can be applied to export XLIFF files for offline localization.
Exportar Traduções
Compilar arquivo ZIP com as últimas traduções.
Estado de Exportação da Tradução
Obter o estado de traduções para exportação.
Transferir Traduções
Download a ZIP file with translations. You can choose the language of translation you need or download all of them at once.
Pré-Tradução
Pre-translate Crowdin project files.
Projetos da Conta
Obter lista dos projetos.
Criar Projeto
Create Crowdin project.
Editar Projeto
Editar o projeto Crowdin.
Apagar Projeto
Apagar o projeto do Crowdin com todsas as traduções.
Adicionar Diretório
Adicionar diretório ao projeto no Crowdin.
Alterar Diretório
Rename directory or modify its attributes. When renaming directory the path can not be changed (it means new_name parameter can not contain path, name only).
Apagar Diretório
Delete Crowdin project directory. All nested files and directories will be deleted too.
Transferir Glossário
Transferir glossários do projeto no Crowdin como ficheiro TBX, CSV, ou XLSX.
Enviar Glossário
Enviar os teus glossários para o Projeto do Crowdin nos formatos dos ficheiros TBX, CSV ou XLS/XLSX.
Transferir MT
Transferir a Memória de Tradução do projeto no Crowdin como ficheiro TMX, CSV, ou XLSX.
Enviar MT
Enviar a tua Memória de Tradução para o Projeto do Crowdin no formato de ficheiro TMX, CSV OU XLS/XLSX.
Idiomas Compatíveis
Obter lista de idiomas suportados com códigos mapeados do Crowdin para o nome do local e códigos padronizados.
Pseudo-Exportar
Gerar ficheiros de pseudo-tradução para todo o projeto.
Pseudo-Transferir
Transferir ficheiro ZIP com pseudo-traduções.
Exportar Relatório de Estimativa de Custo
Generate Costs Estimation report to have an insight on how to plan the budget. This report allows you to calculate the approximate translation cost of currently untranslated strings in the project.
Transferir Relatório da Estimativa de Custo
Transferir o relatório da Estimativa de Custos gerados, anteriormente.
Exportar Relatórios de Custos de Tradução
Gerar receber de Custos de Tradução para calcular o custo real da tradução e saber quanto os teus tradutores e revisores devem receber.
Transferir Relatório dos Custos de Tradução
Transferir o relatório gerado, anteriormente, dos Custos de Tradução.
Exportar Relatório de Melhores Membros
Gerar relatório dos Top Membros, para saber quem contribuiu mais para a tradução do teu projeto durante o período especificado.
Transferir Relatório dos Melhores Membros
Transfira o relatório gerado, anteriormente, no Top Membros.
Crowdin API Java SDK
Crowdin API Java SDK helps you smooth the work with all Crowdin API methods in your Java project, such as adding and updating files, downloading translations or integrating localization with your development process.