API

Traduza JSON e ficheiros, acompanhe o progresso e descarregue as traduções concluídas a partir do seu servidor.

Utilize a API do Lingo.dev para traduzir conteúdo gerido pela sua aplicação. Uma tarefa de localização combina um motor, um idioma de origem, idiomas de destino e um ou mais documentos. Cada documento mantém uma versão de destino para cada idioma solicitado. A maioria dos formatos gera ficheiros de destino separados; os catálogos de cadeias de caracteres da Apple combinam os idiomas num único ficheiro.

O URL base da API é https://api.lingo.dev/v2. Mantenha as credenciais da API no seu servidor. Comece pelo seu primeiro pedido de tradução para traduzir duas mensagens e guardar o resultado.

Escolha os dados de entrada #

O seu conteúdoComece aqui
Um objeto JSON já disponível na sua aplicaçãoTraduzir JSON. Envie o objeto diretamente no pedido de criação.
Ficheiros como JSON, Markdown, HTML ou recursos para aplicações móveisTraduzir documentos. Carregue os bytes originais e descarregue os ficheiros no mesmo formato.
Vários documentos ou idiomas de destinoCriar uma tarefa de tradução. Uma tarefa pode conter tanto JSON incorporado como ficheiros carregados.

As três opções seguem o mesmo ciclo de vida:

  1. Crie uma tarefa e guarde o respetivo ID juntamente com a revisão do conteúdo de origem.
  2. Carregue todos os artefactos indicados na matriz uploads da resposta. Os conteúdos de origem em JSON incorporado são guardados durante a criação.
  3. Inicie a tarefa.
  4. Consulte o progresso até estarem concluídas as versões de destino necessárias de cada documento.
  5. Descarregue cada versão de destino concluída a partir do respetivo status.downloadUrl.

Criar a tarefa guarda o trabalho a realizar; iniciá-la permite que o trabalho avance e começa o processamento. Uma resposta bem-sucedida ao pedido de criação não é um resultado traduzido.

Estime o trabalho antes de criar uma tarefa se precisar de analisar a reutilização e o custo aproximado.

Configure a tradução #

Selecione explicitamente um motor com engineId. Este fornece modelos, glossários, regras e voz da marca, bem como o fluxo de processamento da tradução. A chave de API tem de permitir o acesso à tradução com esse motor.

Para JSON, adicione contexto, indicações e caminhos protegidos específicos do documento através de format.options. Numa revisão posterior, forneça o conteúdo de origem e as traduções anteriores para reutilizar o conteúdo inalterado.

A revisão humana permite que revisores autorizados aprovem ou editem traduções elegíveis antes de o fluxo de processamento continuar. O guia do workflow de revisão explica como articular o envio, a revisão e a entrega.

Mantenha o estado da aplicação associado à tarefa #

Guarde de forma persistente o ID da tarefa, a revisão do conteúdo de origem, as chaves dos documentos e os idiomas solicitados antes de continuar. Utilize o cabeçalho Idempotency-Key ao criar uma tarefa para poder repetir o pedido caso haja incerteza quanto à resposta, sem criar outra tarefa. Obtenha o trabalho existente antes de enviar um novo para o substituir.

Descarregue as versões de destino concluídas mesmo que outra versão falhe. Publique um resultado apenas se ainda corresponder à revisão do conteúdo de origem que a sua aplicação espera. O guia Criar um workflow de tradução explica como coordenar estes passos.

Consulte a autenticação, os erros e o catálogo de erros para obter informações sobre acesso e recuperação.

Prepare e melhore um motor #

O aprovisionamento preenche os glossários, as regras e a voz da marca com base no conteúdo de sites ou em texto. As sugestões do motor transformam comentários em propostas que pode analisar e aplicar. Reveja as orientações geradas antes de as usar como base para a tradução.