مقدمة
يوفر واجهات برمجة تطبيقات RESTful لترجمة الوثائق، مع دعم إدارة مهام الترجمة الآلية واتساق المصطلحات القائم على المسارد والاستعلامات حول التنسيقات واللغات والنماذج المدعومة، مما يسهل بناء سير عمل ترجمة سلس وإدارة حسابات المستخدمين.
البدء
للبدء، تحتاج إلى التقدم بطلب لتصبح مطوراً.التقدم كمطور
بمجرد الموافقة، يمكنك إنشاء مفاتيح API متعددة وتضمين مفتاح API المناسب في كل طلب API حسب الحاجة.
الوصول السريع
Base URL
https://dltranslator.com/api
طريقة المصادقة
Authorization: [yourSecretKey]
طلب JSON
باستثناء واجهة رفع الملفات، تستخدم الواجهات افتراضياً طلبات POST JSON، حيث يكون Content-Type من نوع application/json.
رفع الملف
إنشاء مهمة ترجمة المستند يستخدم multipart/form-data، ويُدخل الملف المراد ترجمته في حقل file.
استجابة الخطأ العامة
عند فشل الطلب، تُرجع الواجهة JSON، حقل error يحتوي على رسالة خطأ إنجليزية ثابتة. يُنصح بمعالجة الأخطاء أولاً حسب رمز حالة HTTP، ويُستخدم حقل error للعرض أو التسجيل.
{
"error": "Invalid API key."
}قواعد رموز حالة الخطأ
تحتفظ جميع استجابات أخطاء v1 API بنفس البنية، يُرجى المعالجة وفقًا لقواعد رمز حالة HTTP التالية.
- 400 Bad Request
- Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
- 401 Unauthorized
- Missing API key or invalid API key.
- 402 Payment Required
- Insufficient credits balance for preview, full translation, or text translation.
- 404 Not Found
- The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
- 409 Conflict
- The current task status does not allow the requested operation.
- 500 Internal Server Error
- Unexpected server exception. The response error is fixed as "Internal server error.".
إجراءات الدمج الموصى بها
1. إنشاء مهمة
رفع الملف وإنشاء مهمة ترجمة، وإرجاع taskId.
2. استعلام التقدم
استطلاع حالة المهمة بشكل دوري، حتى تصبح Completed أو Terminated أو Cancelled.
3. الحصول على النتائج
تنزيل ملف الترجمة، أو قراءة JSON للنص الأصلي والنص المترجم.
4. إدارة المهام
الدفع حسب الاستخدام للترجمة الكاملة للنص، أو إعادة تشغيل المهمة، أو مراجعة النص، أو حذف المهمة.