Translation Task API
Vertaaltaken opvragen
De status en details van een vertalingstaak opvragen.
- Volledig adres
- https://dltranslator.com/api/v1/translation/query
- Authenticatie
- De API Key moet doorgegeven worden in de Authorization-verzoekheader
- Content-Type
- application/json
- Onjuist formaat
- { "error": "Invalid API key." }
Aandachtspunten
Het wordt aanbevolen deze interface te pollen wanneer de taakstatus Waiting of Processing is, en te stoppen met pollen nadat de status Completed, Terminated of Cancelled bereikt.
De downloadlink is een tijdelijk toegangsadres, sla het bestand naar behoefte op aan bedrijfszijde of vraag het opnieuw op.
Voorbeeld
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}'Verzoekparameters
| Parameters | Type | Standaard | Beschrijving | Voorbeeld |
|---|---|---|---|---|
| *taskId | String | - | Vertaalopdracht-ID | - |
Reactie
| Parameters | Type | Standaard | Beschrijving | Voorbeeld |
|---|---|---|---|---|
| taskId | String | - | Taak-ID | - |
| model | String | - | Voor vertaling gebruikt model | - |
| fromLang | String | - | Brontaal | - |
| toLang | String | - | Doeltaal | - |
| status | String | - | Status: 'Init' | 'Wachtend' | 'Verwerking' | 'Voltooid' | 'Beëindigd' | 'Geannuleerd' | - |
| progress | Number | - | Voortgang, 0~100 | - |
| errorMsg | String | - | Foutbericht | - |
| fileTitle | String | - | Originele bestandsnaam | - |
| fileUrl | String | - | Downloadadres origineel bestand | - |
| translatedFileUrl | String | - | Downloadlocatie van de vertaling | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Downloadadres voor bewerkbaar vertaalbestand. Wordt alleen geretourneerd wanneer een bewerkbaar resultaat voor het corresponderende bestandstype wordt gegenereerd. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Documentstatistiek woordaantal. Kan leeg zijn bij verschillende bestandstypen. | - |
| price | Integer | - | Totaal aantal benodigde credits voor de vertaling | - |
| usedCredits | Integer | - | Aantal Credits gebruikt door de vertaaltaak | - |
| glossary | String[] | - | Naam van de terminologielijst gebruikt voor de vertaaltaak | - |
| shouldTranslateImage | Boolean | - | Of afbeeldingen in document te vertalen | - |
| forceOCR | Boolean | - | OCR geforceerd gebruiken voor herkenning van documentinhoud | - |
| createdAt | DateTime | - | Aanmaaktijd van de vertaaltaak | - |
| updatedAt | DateTime | - | Bijwerktijd van de vertaalopdracht | - |
Veelvoorkomende fouten
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.