واجهة برمجة تطبيقات مهام الترجمة
الاستعلام عن مهام الترجمة
الاستعلام عن حالة وتفاصيل مهمة الترجمة.
- العنوان الكامل
- https://dltranslator.com/api/v1/translation/query
- المصادقة
- يجب تمرير API Key في رأس طلب Authorization
- Content-Type
- application/json
- تنسيق خاطئ
- { "error": "Invalid API key." }
ملاحظات
يُنصح بالاستعلام عن هذه الواجهة عندما تكون حالة المهمة Waiting أو Processing، وإيقاف الاستعلام عند انتقال الحالة إلى Completed أو Terminated أو Cancelled.
رابط التنزيل عنوان وصول مؤقت، يرجى حفظ الملف أو إعادة الاستعلام للحصول عليه حسب حاجتك.
مثال
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}'معاملات الطلب
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| *taskId | String | - | معرّف مهمة الترجمة | - |
الاستجابة
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| taskId | String | - | معرف المهمة | - |
| model | String | - | النموذج المستخدم في الترجمة | - |
| fromLang | String | - | اللغة المصدر | - |
| toLang | String | - | اللغة المستهدفة | - |
| status | String | - | الحالة: 'Init' | 'Waiting' | 'Processing' | 'Completed' | 'Terminated' | 'Cancelled' | - |
| 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.