الطلب والاستجابة

هذا قسم تكوين من الترجمة الآلية المخصصة. تحتوي هذه القسم على الإعدادات الأساسية لطلبات الترجمة الآلية.

المتغيرات

• $ID

• $SOURCE_TEXT أو $ORIGINAL_TEXT

• $TRANSLATED_TEXT

• $SOURCE_LANG

• $TARGET_LANG

يمكن استخدام متغيرات المخطط في التكوين بالصيغة $SCHEMA_NAME.

على سبيل المثال:

{
    "schema": [
        { "type": "string", "name": "api_key", "title": "API Key", "default": "", "required": true, "message": "Required an API Key" },
    ],
    "request": {
        "method": "http_post",
        "url": "http://127.0.01/?key=$API_KEY"
        "options": {
            "headers": {
              "Authorization": "Bearer $API_KEY",
              "Content-Type": "application/json"
            }
        }        
    }
}

---

المعلمات

method: string

• "web_scraping"

• "http_get"

• "http_post"

• "web_llm"

العنوان-الأولي: string (اختياري)

عنوان URL الابتدائي للزيارة قبل إجراء الطلب الفعلي (لاستخلاص الويب).

url: string

عنوان نقطة النهاية لخدمة الترجمة الآلية.

encodeURI: boolean (اختياري)

يهرب الأحرف باستخدام وحدات ترميز UTF-8، مع ترميز كل ثُماني بت بالشكل %XX, مع حشو بمقدار 0 على اليسار إذا لزم الأمر. النظائر الوحيدة في UTF-16 لا تشفر أي حرف يونيكود صالح. مرجع: encodeURI

encodeURIComponent: boolean (اختياري)

يستخدم نفس خوارزمية الترميز كما encodeURI. يهرب جميع الأحرف باستثناء: A–Z a–z 0–9 - _ . ! ~ * ' ( ) مرجع: encodeURIComponent

encodeURIExtra: string (اختياري)

دالة إضافية لاستبدال URI باستخدام تعبير نمطي (Regular Expression). على سبيل المثال: ["%2F", "g", "\\%2F"]

userAgent: string (اختياري)

سلسلة User-Agent مخصصة لطلب HTTP.

querySelector: string

يعيد العنصر الأول داخل مستند HTML الذي يطابق المحدد المحدد أو مجموعة المحددات. مرجع: querySelector

querySelectorAll: string (اختياري)

يعيد NodeList ثابت يمثل قائمة من عناصر HTML التي تطابق مجموعة المحددات المحددة. مرجع: querySelectorAll

queryProperty: string

يحدد أي خاصية لاستخراجها من عنصر HTML المحدد:

• "value" - خاصية HTMLDataElement [مرجع]

• "innerText" - خاصية HTMLElement [مرجع]

• "textContent" - خاصية الـ Node [مرجع]

• "innerHTML" - خاصية HTMLElement [مرجع]

body: object

جسم الطلب لطلبات POST. يمكن أن يحتوي على متغيرات مثل $SOURCE_TEXT, $SOURCE_LANG, و $TARGET_LANG.

options: object (اختياري)

خيارات إضافية للطلب.

• headers - تعيين رؤوس طلب مخصصة:

  • X-Custom-Header: string

  • Authorization: string

  • Content-Type: string

responseType: string

• "string" - تعيين نوع الاستجابة كسلسلة نصية

• "json" - تعيين نوع الاستجابة كـ json

responseQuery: string

---

تحليل استجابات JSON من طلبات HTTP

يمكن تحليل استجابات JSON باستخدام responseQuery المعلمة.

يُستخدم responseQuery المعلمة تُستخدم فقط لـ http_get و http_post الطرق عندما يتم ضبط نوع الاستجابة على json.

للتنقل عبر كائنات JSON المتداخلة، استخدم تدوين النقطة (.) لفصل أسماء الحقول. يمكن الوصول إلى عناصر المصفوفة باستخدام تدوين القوس مع مؤشر (على سبيل المثال، [0]).

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

{
  "text": "Hello 1",
  "words": [
    { "text": "Hello 2" },
    { "text": "Hello 3" }
  ]
  "lines": {
    "text": "Hello 4",
    "sub": {
      "text": "Hello 5"
    }        
  }
}

responseQuery	النتيجة
text	Hello 1
words[0].text	Hello 2
lines.sub.text	Hello 5

---

---

أمثلة

1. طريقة استخلاص الويب

المعلمات المطلوبة

• method: string ("web_scraping")

• عنوان URL: string

• querySelector: string

• queryProperty: string

{
    "request": {
        "method": "web_scraping",
        "encodeURI": false,
        "encodeURIComponent": true, 
        "initialUrl": "https://localhost:8080",
        "url": "https://localhost:8080/?sl=$SOURCE_LANG&tl=$TARGET_LANG&text=$SOURCE_TEXT",    
        "querySelector": "span[lang=$TARGET_LANG]",
        "queryProperty": "innerText"
    }
}

---

2. طريقة HTTP GET

المعلمات المطلوبة

• method: string ("http_get")

• عنوان URL: string

• responseType: string

• responseQuery: string

{
    "request": {
        "method": "http_get",
        "encodeURI": false,
        "encodeURIComponent": false, 
        "url": "https://localhost:8080/translate?sl=$SOURCE_LANG&tl=$TARGET_LANG&text=$SOURCE_TEXT",
        "options": {},
        "responseType": "json",
        "responseQuery": "translate.result"
    }
}

---

3. طريقة HTTP POST

المعلمات المطلوبة

• method: string ("http_post")

• عنوان URL: string

• body: object

• options: object

  • headers: object

    • X-Custom-Header: string

    • Authorization: string

    • Content-Type: string

• responseType: string

• responseQuery: string

{
    "request": {
        "method": "http_post",
        "encodeURI": false,
        "encodeURIComponent": false, 
        "url": "https://localhost:8080/translate",
        "body": {
            "text": "$SOURCE_TEXT",
            "source_lang": "$SOURCE_LANG",
            "target_lang": "$TARGET_LANG"
        }
        "options": {
            "headers": {
                "Authorization": "Bearer $API_KEY",
                "Content-Type": "application/json"
            }
        },
        "responseType": "json",
        "responseQuery": "translate.result"
    }
}