واجهة برمجة تطبيقات مهام الترجمة
إعادة تشغيل مهمة الترجمة
يُستخدم لإعادة تشغيل المهام المنتهية، أو دفع النقاط لإجراء الترجمة الكاملة للنص
- العنوان الكامل
- https://otranslator.com/api/v1/translation/start
- المصادقة
- يجب تمرير API Key في رأس طلب Authorization
- Content-Type
- application/json
- تنسيق خاطئ
- { "error": "Invalid API key." }
ملاحظات
يمكن استخدام هذه الواجهة لإعادة تشغيل المهام المنتهية Terminated، كما يمكن بعد اكتمال مهمة المعاينة الدفع عبر payWithCredits وبدء الترجمة الكاملة للنص.
المهام المدفوعة لن تخضع لخصم الرسوم مجدداً. عند تمرير model، يُستخدم فقط لإعادة حساب الرسوم في حال كان payWithCredits بقيمة true والمهمة غير مدفوعة.
مثال
1curl -X POST 'https://otranslator.com/api/v1/translation/start' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'معاملات الطلب
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| *taskId | String | - | معرّف مهمة الترجمة | - |
| payWithCredits | Boolean | - | هل تريد دفع تكلفة مهمة الترجمة، خيار فعال فقط للمستندات غير المدفوعة، حيث لن تُخصم رسوم إضافية من المستندات المدفوعة مسبقاً | - |
| model | String | - |
| - |
الاستجابة
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| success | Boolean | - | هل تم التشغيل بنجاح | - |
الأخطاء الشائعة
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.
402 Insufficient credits balance.
The account does not have enough credits to start the full translation.
404 Task not found.
The task does not exist or does not belong to the current API account.