Translation Task API
Dotaz na překladové úlohy
Dotaz na stav a podrobnosti překladové úlohy.
- Úplná adresa
- https://dltranslator.com/api/v1/translation/query
- Ověření
- V hlavičce požadavku Authorization je nutné předat API Key
- Content-Type
- application/json
- Chybný formát
- { "error": "Invalid API key." }
Upozornění
Doporučuje se dotazovat se na toto rozhraní, když je stav úkolu Waiting nebo Processing, a ukončit dotazování po přechodu do stavu Completed, Terminated nebo Cancelled.
Odkaz ke stažení je dočasná přístupová adresa, soubor si podle potřeby uložte nebo získejte opětovným dotazem.
Pří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}'Parametry požadavku
| Parametry | Typ | Výchozí | Popis | Příklad |
|---|---|---|---|---|
| *taskId | String | - | ID překladatelského úkolu | - |
Odpověď
| Parametry | Typ | Výchozí | Popis | Příklad |
|---|---|---|---|---|
| taskId | String | - | ID úlohy | - |
| model | String | - | Model použitý pro překlad | - |
| fromLang | String | - | Zdrojový jazyk | - |
| toLang | String | - | Cílový jazyk | - |
| status | String | - | Stav: 'Init' | 'Čekání' | 'Zpracování' | 'Dokončeno' | 'Ukončeno' | 'Zrušeno' | - |
| progress | Number | - | Pokrok, 0~100 | - |
| errorMsg | String | - | Chybová zpráva | - |
| fileTitle | String | - | Název původního souboru | - |
| fileUrl | String | - | Adresa pro stažení původního souboru | - |
| translatedFileUrl | String | - | Adresa pro stažení překladu | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Adresa pro stažení editovatelného souboru překladu. Vrací se pouze pokud je pro daný typ souboru vygenerován editovatelný výsledek. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Statistika počtu slov dokumentu. U různých typů souborů může být prázdná. | - |
| price | Integer | - | Celkový počet kreditů potřebný pro překlad | - |
| usedCredits | Integer | - | Počet kreditů použitých překladovou úlohou | - |
| glossary | String[] | - | Název glosáře používaného překladovou úlohou | - |
| shouldTranslateImage | Boolean | - | Zda přeložit obrázky v dokumentu | - |
| forceOCR | Boolean | - | Vynutit použití OCR pro rozpoznání obsahu dokumentu | - |
| createdAt | DateTime | - | Čas vytvoření překladové úlohy | - |
| updatedAt | DateTime | - | Čas aktualizace překladové úlohy | - |
Běž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.