واجهة برمجة تطبيقات مهام الترجمة
نص الترجمة
ترجمة النص وإرجاع نتائج الترجمة بشكل متزامن.
- العنوان الكامل
- https://dltranslator.com/api/v1/translation/translateTexts
- المصادقة
- يجب تمرير API Key في رأس طلب Authorization
- Content-Type
- application/json
- تنسيق خاطئ
- { "error": "Invalid API key." }
ملاحظات
تقوم هذه الواجهة بحفظ النص المُدخل مؤقتاً كمستند JSON ومعالجته بشكل متزامن، وهي مناسبة للترجمة الفورية لدفعات صغيرة من النصوص.
رصيد نقاط الحساب يحتاج إلى 2 credits على الأقل. إذا تجاوزت التكلفة الفعلية الرصيد، ستعيد الواجهة taskId و price، وتنبه بعدم كفاية الرصيد.
مثال
1curl -X POST 'https://dltranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "texts": [
6 "string"
7 ],
8 "fromLang": "[string]",
9 "toLang": "[string]"
10}'معاملات الطلب
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| *texts | String[] | - | النص المطلوب ترجمته | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| model | String | - |
| - |
| fileDescription | String | - | وصف المستند، من خلال توفير معلومات إضافية، يتم تحسين جودة الترجمة، مثل إضافة معلومات السياق الإضافية للمستند ومتطلبات الترجمة الأخرى وغيرها | - |
الاستجابة
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| taskId | String | - | معرف المهمة | - |
| translatedTexts | String[] | - | النص المترجم | - |
| price | Integer | - | عدد الـ Credits المطلوبة للترجمة الكاملة | - |
| usedCredits | Integer | - | عدد النقاط المستخدمة في مهمة الترجمة | - |
الأخطاء الشائعة
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.
402 Insufficient credits balance.
The account does not have enough credits to translate the texts.
400 Missing required parameter: fromLang.
Provide fromLang using a language returned by /api/v1/languages.
400 Missing required parameter: toLang.
Provide toLang using a language returned by /api/v1/languages.
400 Missing required parameter: texts.
Provide a non-empty texts array.
400 Failed to translate texts.
The text translation task could not be processed.