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údo | Comece aqui |
|---|---|
| Um objeto JSON já disponível na sua aplicação | Traduzir JSON. Envie o objeto diretamente no pedido de criação. |
| Ficheiros como JSON, Markdown, HTML ou recursos para aplicações móveis | Traduzir documentos. Carregue os bytes originais e descarregue os ficheiros no mesmo formato. |
| Vários documentos ou idiomas de destino | Criar 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:
- Crie uma tarefa e guarde o respetivo ID juntamente com a revisão do conteúdo de origem.
- Carregue todos os artefactos indicados na matriz
uploadsda resposta. Os conteúdos de origem em JSON incorporado são guardados durante a criação. - Inicie a tarefa.
- Consulte o progresso até estarem concluídas as versões de destino necessárias de cada documento.
- 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.