المترجم 3.0: الكشف

  • مقالة
  • قراءة خلال 2 دقائق

يحدد لغة قطعة من النص.

URL للطلب

أرسل طلبا POST إلى:

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

معلمات الطلب

معلمات الطلب التي تم تمريرها على سلسلة الاستعلام هي:

معلمة الاستعلام الوصف
api-version المعلمة المطلوبة.
إصدار واجهة برمجة التطبيقات التي يطلبها العميل. يجب أن تكون القيمة 3.0.

تتضمن رؤوس الطلبات ما يلي:

الرؤوس الوصف
رأس (رؤوس) المصادقة رأس الطلب المطلوب.
اطلع على الخيارات المتاحة للمصادقة.
نوع المحتوى رأس الطلب المطلوب.
يحدد نوع محتوى الحمولة. القيم المحتملة هي: application/json.
طول المحتوى رأس الطلب المطلوب.
طول نص الطلب.
X-ClientTraceId اختياري.
معرّف GUID تم إنشاؤه بواسطة العميل لتعريف الطلب بشكل فريد. لاحظ أنه يمكنك حذف هذا الرأس إذا قمت بتضمين معرف التتبع في سلسلة الاستعلام باستخدام معلمة استعلام تسمى ClientTraceId.

نص الطلب

نص الطلب عبارة عن صفيف JSON. كل عنصر صفيف هو كائن JSON مع خاصية سلسلة تسمى Text. يتم تطبيق الكشف عن اللغة على قيمة Text الخاصية. يعمل الكشف التلقائي عن اللغة بشكل أفضل مع نص الإدخال الأطول. يبدو نص طلب العينة كما يلي:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

تنطبق القيود التالية:

  • يمكن أن تحتوي الصفيف على 100 عنصر على الأكثر.
  • لا يمكن أن يتجاوز النص الكامل المضمن في الطلب 50000 حرف بما في ذلك المسافات.

هيئة الاستجابة

الاستجابة الناجحة هي صفيف JSON مع نتيجة واحدة لكل سلسلة في صفيف الإدخال. يتضمن كائن النتيجة الخصائص التالية:

  • languageرمز اللغة المكتشفة.:

  • scoreقيمة عائمة تشير إلى الثقة في النتيجة.: تتراوح النتيجة بين صفر وواحد وتشير الدرجة المنخفضة إلى انخفاض الثقة.

  • isTranslationSupportedقيمة منطقية صحيحة إذا كانت اللغة المكتشفة إحدى اللغات المدعومة لترجمة النص.:

  • isTransliterationSupportedقيمة منطقية صحيحة إذا كانت اللغة المكتشفة إحدى اللغات المدعومة للترجمة الحرفية.:

  • alternativesمجموعة من اللغات الأخرى الممكنة.: كل عنصر من عناصر الصفيف هو كائن آخر له نفس الخصائص المذكورة أعلاه: language، ، isTranslationSupportedscoreو isTransliterationSupported.

مثال على استجابة JSON هو:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

رؤوس الاستجابة

الرؤوس الوصف
X-RequestId القيمة التي تم إنشاؤها بواسطة الخدمة لتحديد الطلب. يتم استخدامه لأغراض استكشاف الأخطاء وإصلاحها.

رموز حالة الاستجابة

فيما يلي رموز حالة HTTP المحتملة التي يقوم الطلب بإرجاعها.

تعليمة برمجية للحالة الوصف
200 نجاح
400 إحدى معلمات الاستعلام مفقودة أو غير صالحة. تصحيح معلمات الطلب قبل إعادة المحاولة.
401 تعذر المصادقة على الطلب. تحقق من أن بيانات الاعتماد محددة وصالحة.
403 الطلب غير مصرح به. تحقق من رسالة خطأ التفاصيل. غالبا ما يشير هذا إلى أن جميع الترجمات المجانية المقدمة مع اشتراك تجريبي قد تم استهلاكها.
429 رفض الخادم الطلب لأن العميل قد تجاوز حدود الطلب.
500 حدث خطأ غير متوقع. إذا استمر الخطأ، فقم بالإبلاغ عنه باستخدام: تاريخ ووقت الفشل، ومعرف الطلب من رأس الاستجابة، ومعرف العميل من رأس X-RequestIdX-ClientTraceIdالطلب.
503 الخادم غير متوفر مؤقتا. أعد محاولة الطلب. إذا استمر الخطأ، فقم بالإبلاغ عنه باستخدام: تاريخ ووقت الفشل، ومعرف الطلب من رأس الاستجابة، ومعرف العميل من رأس X-RequestIdX-ClientTraceIdالطلب.

في حالة حدوث خطأ، سيقوم الطلب أيضا بإرجاع استجابة خطأ JSON. رمز الخطأ عبارة عن رقم مكون من 6 أرقام يجمع بين رمز حالة HTTP المكون من 3 أرقام متبوعا برقم مكون من 3 أرقام لزيادة تصنيف الخطأ. يمكن العثور على رموز الخطأ الشائعة في صفحة مرجع v3 المترجم.

أمثلة

يوضح المثال التالي كيفية استرداد اللغات المعتمدة لترجمة النص.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"