API Zadania Tłumaczenia
Zapytanie o zadania tłumaczenia
Wyświetl status i szczegóły zadania tłumaczeniowego.
- Pełny adres
- https://dltranslator.com/api/v1/translation/query
- Uwierzytelnienie
- Należy przekazać API Key w nagłówku żądania Authorization
- Content-Type
- application/json
- Nieprawidłowy format
- { "error": "Invalid API key." }
Uwagi
Zaleca się odpytywanie tego interfejsu, gdy status zadania to Waiting lub Processing, i zatrzymanie odpytywania po wejściu statusu w Completed, Terminated lub Cancelled.
Link do pobrania to tymczasowy adres dostępu, należy zapisać plik lokalnie według potrzeb lub ponownie wykonać zapytanie.
Przykład
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 żądania
| Parametry | Typ | Domyślny | Opis | Przykład |
|---|---|---|---|---|
| *taskId | String | - | ID zadania tłumaczenia | - |
Odpowiedź
| Parametry | Typ | Domyślny | Opis | Przykład |
|---|---|---|---|---|
| taskId | String | - | ID zadania | - |
| model | String | - | Model używany podczas tłumaczenia | - |
| fromLang | String | - | Język źródłowy | - |
| toLang | String | - | Język docelowy | - |
| status | String | - | Status: 'Init' | 'Waiting' | 'Processing' | 'Completed' | 'Terminated' | 'Cancelled' | - |
| progress | Number | - | Postęp, 0~100 | - |
| errorMsg | String | - | Komunikat o błędzie | - |
| fileTitle | String | - | Nazwa oryginalnego pliku | - |
| fileUrl | String | - | Adres pobierania oryginalnego pliku | - |
| translatedFileUrl | String | - | Adres pobierania tłumaczenia | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Adres pobierania edytowalnego pliku tłumaczenia. Zwracany tylko gdy dla odpowiedniego typu pliku generowany jest edytowalny wynik. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Statystyka słów dokumentu. Może być pusta dla różnych typów plików. | - |
| price | Integer | - | Całkowita liczba kredytów potrzebnych do tłumaczenia | - |
| usedCredits | Integer | - | Liczba punktów Credits wykorzystanych przez zadanie tłumaczenia | - |
| glossary | String[] | - | Nazwa słownika terminologicznego używanego w zadaniu tłumaczenia | - |
| shouldTranslateImage | Boolean | - | Czy tłumaczyć obrazy w dokumencie | - |
| forceOCR | Boolean | - | Czy wymuszać użycie OCR do rozpoznawania zawartości dokumentu | - |
| createdAt | DateTime | - | Czas utworzenia zadania tłumaczenia | - |
| updatedAt | DateTime | - | Czas aktualizacji zadania tłumaczeniowego | - |
Typowe błędy
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.