Translator 3.0: BreakSentence

  • مقالة

تحديد موضع حدود الجملة في جزء من النص.

URL للطلب

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

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

معلمات الطلب

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

معلمة الاستعلام الوصف
إصدار API المعلمة الخاصة بالاستعلام المطلوبة.
إصدار API التي طلبها العميل. يجب أن تكون القيمة 3.0.
اللغة معلمة الاستعلام الاختيارية.
العلامة الخاصة باللغة التي تحدد لغة نص الإدخال. إذا لم يتم تحديد رمز، فسيتم تطبيق الكشف التلقائي عن اللغة.
البرنامج النصي معلمة الاستعلام الاختيارية.
علامة البرنامج النصي التي تحدد البرنامج النصي المستعمل بواسطة نص الإدخال. إذا لم يتم تحديد برنامج نصي، فسيتم افتراض البرنامج النصي الافتراضي للغة.

تشمل عناوين الطلبات ما يلي:

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

نص الطلب

يعد نص الطلب هو صفيف JSON. كل عنصر صفيف هو عنصرJSON مع خاصية سلسلة تسمى Text. يتم حساب حدود الجملة الخاصة بقيمة الخاصيةText. يبدو نص طلب العينة مع جزء واحد من النص كالتالي:

[
    { "Text": "How are you? I am fine. What did you do today?" }
]

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

  • يمكن أن يحتوي الصفيف على 100 عنصر على الأكثر.
  • لا يمكن أن تتجاوز القيمة النصية لعنصر صفيف 50000 حرف بما في ذلك المسافات.
  • لا يمكن أن يتجاوز النص بأكمله المضمن في الطلب 50000 حرف بما في ذلك المسافات.
  • في حالة language تم تحديد معلمة الاستعلام، فيجب أن تكون كافة عناصر الصفيف بنفس اللغة. وإلا، يتم تطبيق الكشف التلقائي للغة على كل عنصر صفيف بنحو مستقل.

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

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

  • sentLen: صفيف من الأعداد السليمة التي تمثل أطوال الجمل في عنصر النص. طول الصفيف هو عدد جميع الجمل، والقيم هي طول كل جملة.

  • detectedLanguage: عنصر يصف اللغة المكتشفة من خلال الخصائص التالية:

    • languageتعليمة برمجية اللغة المكتشفة.

    • score: قيمة حرة تشير إلى الثقة في النتيجة. النتيجة بين صفر (0) وواحد (1.0). تشير الدرجة المنخفضة (<= 0.4) إلى انخفاض الثقة.

الخاصية detectedLanguage موجودة فقط في كائن النتيجة عند طلب الكشف التلقائي للغة.

مثال JSON للاستجابة:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "sentLen": [
            13,
            11,
            22
        ]
    }
]

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

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

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

فيما يلي تعليمات حالة HTTP البرمجية المحتملة التي يعرضها الطلب.

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

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

أمثلة

يوضح المثال التالي طريقة الحصول على حدود الجملة لجملة واحدة. يتم الكشف عن لغة الجملة بطريقة تلقائية بواسطة الخدمة.

curl -X POST "https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"