Configurando a integração da API
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.
O Crowdin fornece a API RESTful com XML ou JSON via HTTP usando os métodos GET ou POST. Listados abaixo estão todos os métodos de API disponíveis que permitem criar projetos no Crowdin, adicione e atualize arquivos, baixe traduções ou integre a localização ao seu processo de desenvolvimento.
Adquirindo e usando uma chave de API
Para encontrar sua chave de API da conta, você precisa fazer o login na sua conta do Crowdin. Abra a página Configurações da conta e mude para a aba de API.
Por favor, note que quase todas as chamadas de API requerem o Identificador do Projeto (ID). Você pode encontrar o identificador do seu projeto nas configurações do projeto > aba de API e Webhooks.
Fazendo pedidos
Para cada solicitação de API que você fizer, será necessário apresentar a chave da API da conta e o nome de usuário como parâmetros de URI principais a serem autenticados. Mantenha a chave da API da sua conta em segredo! Deve ser guardado apenas como sua senha normal da conta.
Veja um exemplo e um princípio de formação de URI de solicitação de API.
GET https://api.crowdin.com/api/project/{project-identifier}/download/all.zip?login={username}&account-key={account-key}
O URL de chamada da API típica é semelhante ao seguinte:https://api.crowdin.com/api/project/. O primeiro espaço reservado (palavra-chave entre colchetes) contém o identificador do projeto. A chave e o nome de usuário da API da conta são especificados como parâmetros de URI.
Limites de taxa
O número de chamadas simultâneas à API por conta é de 20 solicitações. Se o limite for excedido, o código de erro 429 será exibido com uma mensagem: “O número máximo de solicitações simultâneas para este terminal é atingido. Por favor tente novamente mais tarde.
Usar o Postman
Postman é uma ferramenta que permite trabalhar com a API Crowdin de uma maneira simples.
Todos os métodos da API do Crowdin disponíveis já estão salvos como uma coleção no Postman. Clique em Executar no Postman para importar e abrir essa coleção diretamente no aplicativo Postman.
Métodos
Adicionar arquivo
Adicione o diretório ao projeto do Crowdin.
Atualizar arquivo
Carregue a versão mais recente dos seus arquivos de origem (os que devem ser localizados) para o seu projeto de crowdin.
Excluir arquivo
Excluir o arquivo do projeto do Crowdin. Todas as traduções serão perdidas sem a capacidade de restaurá-las.
Enviar tradução
Carregue as traduções existentes para o seu projeto Crowdin. O método não está funcionando parar Localização de assets.
Estado da tradução
Acompanhe a tradução global e a revisão de progresso de cada idioma alvo. O formato de resposta padrão é 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 relatados
Obtenha uma lista de problemas relatados no Editor.
Exportar arquivo
Este método exporta arquivos traduzidos únicos do Crowdin. Além disso, ele pode ser aplicado para exportar arquivos XLIFF para localização off-line.
Exportar traduções
Crie o arquivo ZIP com as últimas traduções.
Estado de exportação da tradução
Obter o status de traduções para exportação.
Baixar traduções
Download um arquivo ZIP com traduções. Você pode escolher o idioma de tradução de que precisa ou baixar todos de uma só vez.
Pre-Tradução
Pré-traduza os arquivos do projeto Crowdin.
Projetos da conta
Obter uma lista de projetos.
Criar projeto
Crie o projeto do Crowdin.
Editar projeto
Edite o projeto Crowdin.
Excluir projeto
Exclua o projeto Crowdin com todas as traduções.
Adicionar diretório
Adicione o diretório ao projeto do Crowdin.
Alterar o diretório
Renomeie o diretório ou modifique seus atributos. Quando mudar o nome de diretório, o caminho não pode ser alterado (significa new_name parâmetro não pode conter o caminho, o nome apenas).
Eliminar o diretório
Exclua o diretório do projeto do Crowdin. Todos os arquivos e diretórios aninhados serão excluídos também.
Baixar glossário
Download os glossários do projeto Crowdin como arquivo TBX, CSV, ou XLSX.
Enviar glossário
Faça o upload de seus glossários para Crowdin Project nos formatos de arquivo TBX, CSV ou XLS/XLSX.
Baixar memória de tradução
Download as memorias de tradução do projeto Crowdin como arquivo TMX, CSV, ou XLSX.
Enviar memória de tradução
Carregue sua Memória de Tradução para o Projeto Crowdin no formato de arquivo TMX, CSV ou XLS / XLSX.
Idiomas compatíveis
Obtenha uma lista de idiomas suportados com códigos Crowdin mapeados para o nome da localidade e os códigos padronizados.
Pseudoexportar
Gerar arquivos de pseudotradução para todo o projeto.
Pseudobaixar
Download o arquivo ZIP com pseudo-traduções.
Relatório de estimativa de custos de exportação
Gerar o Relatório de estimativa de custos para ter uma ideia de como planejar o orçamento. Este relatório permite calcular o custo de tradução aproximado de strings atualmente não traduzidas no projeto.
Relatório de estimativa de custos de download
Faça o download do relatório de estimativa de custos gerado anteriormente.
Relatório de custos de tradução de exportação
Gere custos de tradução para calcular o custo real de tradução e saber quanto os tradutores e revisores devem receber.
Download relatório de custos de tradução
Download o relatório de custos de tradução gerado anteriormente.
Exportar relatório de membros mais importantes
Os membros do Gerar Membros Principai sabem quem contribuiu mais para a tradução do seu projeto durante o período especificado.
Download o relatório dos membros principais
Faça o download do relatório de membros principais gerado anteriormente.
Crowdin API Java SDK
API do Crowdin para Java SDK ajuda a facilitar o trabalho com todos os métodos da API do Crowdin em seu projeto Java, como adicionar e atualizar arquivos, baixar traduções ou integrar a localização ao seu processo de desenvolvimento.