API Attività di Traduzione
Consulta le attività di traduzione
Consultare lo stato e i dettagli di un'attività di traduzione.
- Indirizzo completo
- https://dltranslator.com/api/v1/translation/query
- Autenticazione
- È necessario passare la API Key nell'intestazione della richiesta Authorization
- Content-Type
- application/json
- Formato errato
- { "error": "Invalid API key." }
Note importanti
Si consiglia di effettuare il polling di questa interfaccia quando lo stato dell'attività è Waiting o Processing, e di interrompere il polling dopo che lo stato è passato a Completed, Terminated o Cancelled.
Il link di download è un indirizzo di accesso temporaneo, si prega di salvare il file o effettuare una nuova richiesta in base alle necessità dal lato business.
Esempio
1curl -X POST 'https://dltranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Parametri della Richiesta
| Parametri | Tipo | Predefinito | Descrizione | Esempio |
|---|---|---|---|---|
| *taskId | String | - | ID dell'attività di traduzione | - |
Risposta
| Parametri | Tipo | Predefinito | Descrizione | Esempio |
|---|---|---|---|---|
| taskId | String | - | ID attività | - |
| model | String | - | Modello utilizzato per la traduzione | - |
| fromLang | String | - | Lingua di origine | - |
| toLang | String | - | Lingua di destinazione | - |
| status | String | - | Stato: 'Init' | 'Attesa' | 'Elaborazione' | 'Completato' | 'Terminato' | 'Annullato' | - |
| progress | Number | - | Progresso, 0~100 | - |
| errorMsg | String | - | Messaggio di errore | - |
| fileTitle | String | - | Nome del file originale | - |
| fileUrl | String | - | Indirizzo di download del file originale | - |
| translatedFileUrl | String | - | Indirizzo di download della traduzione | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Indirizzo di download del file di traduzione modificabile. Viene restituito solo quando per il tipo di file corrispondente viene generato un risultato modificabile. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Conteggio delle parole del documento. Può essere vuoto a seconda del tipo di file. | - |
| price | Integer | - | Numero totale di Credits richiesti per la traduzione completa | - |
| usedCredits | Integer | - | Numero di crediti utilizzati dall'attività di traduzione | - |
| glossary | String[] | - | Nome del glossario utilizzato dall'attività di traduzione | - |
| shouldTranslateImage | Boolean | - | Se tradurre le immagini nel documento | - |
| forceOCR | Boolean | - | Forza l'uso dell'OCR per riconoscere il contenuto del documento | - |
| createdAt | DateTime | - | Orario di creazione dell'attività di traduzione | - |
| updatedAt | DateTime | - | Ora di aggiornamento dell'attività di traduzione | - |
Errori comuni
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.