API de Tarefa de Tradução
Consultar tarefa de tradução
Consultar o estado e detalhes de uma tarefa de tradução.
- Endereço completo
- https://otranslator.com/api/v1/translation/query
- Autenticação
- É necessário transmitir a API Key no cabeçalho de pedido Authorization
- Content-Type
- application/json
- Formato incorreto
- { "error": "Invalid API key." }
Precauções
Recomenda-se fazer polling desta interface quando o estado da tarefa for Waiting ou Processing, parando o polling quando o estado entrar em Completed, Terminated ou Cancelled.
O link de descarregamento é um endereço de acesso temporário, guarde o ficheiro conforme necessário ou consulte novamente para obter.
Exemplo
1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Parâmetros do Pedido
| Parâmetros | Tipo | Predefinição | Descrição | Exemplo |
|---|---|---|---|---|
| *taskId | String | - | ID da tarefa de tradução | - |
Resposta
| Parâmetros | Tipo | Predefinição | Descrição | Exemplo |
|---|---|---|---|---|
| taskId | String | - | ID da Tarefa | - |
| model | String | - | Modelo utilizado na tradução | - |
| fromLang | String | - | Idioma Original | - |
| toLang | String | - | Idioma de destino | - |
| status | String | - | Estado: 'Init' | 'Waiting' | 'Processing' | 'Completed' | 'Terminated' | 'Cancelled' | - |
| progress | Number | - | Progresso, 0~100 | - |
| errorMsg | String | - | Informação de erro | - |
| fileTitle | String | - | Nome do ficheiro original | - |
| fileUrl | String | - | Endereço de download do ficheiro original | - |
| translatedFileUrl | String | - | Endereço de transferência da tradução | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Endereço de download do ficheiro de tradução editável. Devolvido apenas quando o resultado editável é gerado para o tipo de ficheiro correspondente. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Contagem de palavras do documento. Pode estar vazio consoante o tipo de ficheiro. | - |
| price | Integer | - | Número total de Credits necessários para a tradução | - |
| usedCredits | Integer | - | Número de Credits utilizados pela tarefa de tradução | - |
| glossary | String[] | - | Nome do glossário utilizado pela tarefa de tradução | - |
| shouldTranslateImage | Boolean | - | Se deve traduzir as imagens no documento | - |
| forceOCR | Boolean | - | Forçar utilização de OCR para reconhecer conteúdo do documento | - |
| createdAt | DateTime | - | Hora de criação da tarefa de tradução | - |
| updatedAt | DateTime | - | Hora de actualização da tarefa de tradução | - |
Erros Comuns
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
404 Task not found.
The task does not exist, has been deleted, does not belong to the current API account, or was not created through the API.