Configurando a integração da API

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 com o seu processo de desenvolvimento.

Adquirindo e usando uma chave de API

Para encontrar sua chave de API do projeto, você precisa fazer o login na sua conta Crowdin. Encontre o projeto, abra a página Configurações do projeto e ative a guia API.

Por favor, note que quase todas as chamadas de API requerem o Identificador do Projeto (ID). Você pode encontrar seu identificador de projeto logo acima da chave da API.

Fazendo pedidos

Para cada solicitação de API feita, você precisará apresentar a chave de acesso da API como o parâmetro URI principal a ser autenticado. Mantenha a chave da API 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.

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 de acesso da API é especificada como um parâmetro do 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 Crowdin disponíveis já estão salvos como uma coleção no Postman. Clique Executar Postman para importar e abrir essa coleção diretamente no aplicativo Postman.

Métodos