Translation Task API
Dotaz na prekladové úlohy
Vyhľadať stav a podrobnosti prekladovej úlohy.
- Úplná adresa
- https://dltranslator.com/api/v1/translation/query
- Autentifikácia
- Je potrebné poskytnúť API Key v hlavičke požiadavky Authorization
- Content-Type
- application/json
- Chybný formát
- { "error": "Invalid API key." }
Upozornenia
Odporúčame dotazovať sa na toto rozhranie, keď je stav úlohy Waiting alebo Processing, a zastaviť dotazovanie po prechode stavu na Completed, Terminated alebo Cancelled.
Odkaz na stiahnutie je dočasná prístupová adresa, uložte si súbor alebo ho získajte opätovným dotazom podľa potreby vo vašej aplikácii.
Príklad
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}'Parametre požiadavky
| Parametre | Typ | Predvolené | Popis | Príklad |
|---|---|---|---|---|
| *taskId | String | - | ID prekladovej úlohy | - |
Odpoveď
| Parametre | Typ | Predvolené | Popis | Príklad |
|---|---|---|---|---|
| taskId | String | - | ID úlohy | - |
| model | String | - | Model použitý na preklad | - |
| fromLang | String | - | Zdrojový jazyk | - |
| toLang | String | - | Cieľový jazyk | - |
| status | String | - | Stav: 'Inicializácia' | 'Čakanie' | 'Spracovanie' | 'Dokončené' | 'Ukončené' | 'Zrušené' | - |
| progress | Number | - | Progres, 0~100 | - |
| errorMsg | String | - | Chybová správa | - |
| fileTitle | String | - | Názov pôvodného súboru | - |
| fileUrl | String | - | Adresa na stiahnutie pôvodného súboru | - |
| translatedFileUrl | String | - | Adresa na stiahnutie prekladu | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Adresa na stiahnutie editovateľného prekladového súboru. Vracia sa len pri generovaní editovateľného výsledku pre zodpovedajúci typ súboru. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Počet slov v dokumente. Môže byť prázdne pri rôznych typoch súborov. | - |
| price | Integer | - | Celkový počet kreditov potrebných na preklad | - |
| usedCredits | Integer | - | Počet kreditov použitých prekladovou úlohou | - |
| glossary | String[] | - | Názov glosára používaného prekladovou úlohou | - |
| shouldTranslateImage | Boolean | - | Či preložiť obrázky v dokumente | - |
| forceOCR | Boolean | - | Či vynútiť používanie OCR na rozpoznanie obsahu dokumentu | - |
| createdAt | DateTime | - | Čas vytvorenia prekladovej úlohy | - |
| updatedAt | DateTime | - | Čas aktualizácie prekladovej úlohy | - |
Bežné chyby
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.