المترجم 3.0: BreakSentence

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

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

URL للطلب

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

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

معلمات الطلب

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

معلمة الاستعلام الوصف
إصدار واجهة برمجة التطبيقات معلمة الاستعلام المطلوبة.
إصدار واجهة برمجة التطبيقات التي يطلبها العميل. يجب أن تكون القيمة 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قيمة عائمة تشير إلى الثقة في النتيجة.: تتراوح النتيجة بين صفر وواحد وتشير الدرجة المنخفضة إلى انخفاض الثقة.

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

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

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

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

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

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

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

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

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

أمثلة

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

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?'}]"