Introdução
Fornece APIs RESTful para tradução de documentos, suportando gestão automatizada de tarefas de tradução, consistência terminológica baseada em glossários e consultas de formatos, idiomas e modelos suportados, facilitando a criação de fluxos de trabalho de tradução integrados e a gestão de contas de utilizador.
Começar
Para começar, precisa de se candidatar para se tornar programador.Candidatar-se como programador
Uma vez aprovado, pode criar múltiplas chaves de API e incluir a chave de API apropriada em cada pedido de API conforme necessário.
Acesso Rápido
Base URL
https://dltranslator.com/api
Método de autenticação
Authorization: [yourSecretKey]
JSON 请求
Exceto a interface de upload de ficheiros, as interfaces usam por padrão pedidos POST JSON, com Content-Type application/json.
Carregamento de ficheiro
A criação de uma tarefa de tradução de documentos utiliza multipart/form-data, o campo file transmite o ficheiro a ser traduzido.
Resposta de erro geral
Quando a solicitação falha, a interface devolve JSON, o campo error contém a mensagem de erro fixa em inglês. Recomenda-se priorizar o tratamento de erros com base no código de status HTTP, o campo error é usado para apresentação ou registo em logs.
{
"error": "Invalid API key."
}Regras de código de estado de erro
Todas as respostas de erro da API v1 mantêm a mesma estrutura, processe de acordo com as seguintes regras de códigos de status HTTP.
- 400 Bad Request
- Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
- 401 Unauthorized
- Missing API key or invalid API key.
- 402 Payment Required
- Insufficient credits balance for preview, full translation, or text translation.
- 404 Not Found
- The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
- 409 Conflict
- The current task status does not allow the requested operation.
- 500 Internal Server Error
- Unexpected server exception. The response error is fixed as "Internal server error.".
Fluxo de integração recomendado
1. Criar tarefa
Carregar ficheiro e criar tarefa de tradução, retornando o taskId.
2. Consultar progresso
Consultar o estado da tarefa até Completed, Terminated ou Cancelled.
3. Obter resultados
Descarregar ficheiro traduzido ou ler o JSON do original e da tradução.
4. Gerir tarefas
Pagamento conforme a utilização para tradução de texto completo, reiniciar tarefas, rever texto ou apagar tarefas.