API за преводна задача
Заявка за задачата за превод
Заявка за статуса и подробностите на преводаческата задача.
- Пълен адрес
- https://otranslator.com/api/v1/translation/query
- Удостоверяване
- Необходимо е API Key да се предаде в заглавката Authorization на заявката
- Content-Type
- application/json
- Грешен формат
- { "error": "Invalid API key." }
Забележки
Препоръчва се този интерфейс да се изпитва периодично (polling), когато статусът на задачата е Waiting или Processing, и да се спре след като статусът премине в Completed, Terminated или Cancelled.
Връзката за изтегляне е временен адрес за достъп, моля запазете файла при необходимост или заявете отново за получаване.
Пример
1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Параметри на заявката
| Параметри | Тип | По подразбиране | Описание | Пример |
|---|---|---|---|---|
| *taskId | String | - | ИД на преводаческа задача | - |
Отговор
| Параметри | Тип | По подразбиране | Описание | Пример |
|---|---|---|---|---|
| taskId | String | - | ID на задачата | - |
| model | String | - | Модел, използван при превода | - |
| fromLang | String | - | Изходен език | - |
| toLang | String | - | Целеви език | - |
| status | String | - | Състояние: 'Инициализация' | 'Изчакване' | 'Обработка' | 'Завършено' | 'Прекратено' | 'Отменено' | - |
| progress | Number | - | напредък, 0~100 | - |
| errorMsg | String | - | Съобщение за грешка | - |
| fileTitle | String | - | Име на оригиналния файл | - |
| fileUrl | String | - | Адрес за изтегляне на оригиналния файл | - |
| translatedFileUrl | String | - | Адрес за изтегляне на превода | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Адрес за изтегляне на редактируемия файл с превода. Връща се само при генериране на редактируем резултат за съответния тип файл. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Брой думи в документа. Може да е празно при различни типове файлове. | - |
| price | Integer | - | Общо необходими Credits за превода | - |
| usedCredits | Integer | - | Брой използвани кредити за задачата за превод | - |
| glossary | String[] | - | Име на терминологичния речник, използван за задачата за превод | - |
| shouldTranslateImage | Boolean | - | Дали да се преведат изображенията в документа | - |
| forceOCR | Boolean | - | Дали да се използва принудително OCR за разпознаване на съдържанието на документа | - |
| createdAt | DateTime | - | Време на създаване на задачата за превод | - |
| updatedAt | DateTime | - | Време за актуализация на преводната задача | - |
Чести грешки
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.