İstek & Yanıt

Bu, Özel MT. Bu bölüm Makine Çevirisi istekleri için temel yapılandırmayı içerir.

Değişkenler

• $ID

• $SOURCE_TEXT veya $ORIGINAL_TEXT

• $TRANSLATED_TEXT

• $SOURCE_LANG

• $TARGET_LANG

Şema değişkenleri yapılandırmada şu sözdizimi ile kullanılabilir $SCHEMA_NAME.

Örneğin:

{
    "şema": [
        { "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"
            }
        }        
    }
}

---

Parametreler

method: string

• "web_scraping"

• "http_get"

• "http_post"

• "web_llm"

initialUrl: string (isteğe bağlı)

Gerçek isteği yapmadan önce ziyaret edilecek başlangıç URL'si (web kazıma için).

url: string

Makine Çeviri hizmetinin uç nokta URL'si.

encodeURI: boolean (isteğe bağlı)

Karakterleri UTF-8 kod birimleri kullanarak kaçırır; her oktet şu formatta kodlanır %XX, gerektiğinde sola 0 eklenmiş. UTF-16'daki tek başına duran eşdeğerler geçerli bir Unicode karakterini kodlamaz. Referans: encodeURI

encodeURIComponent: boolean (isteğe bağlı)

Aynı kodlama algoritmasını kullanır encodeURI. Aşağıdakiler hariç tüm karakterleri kaçırır: A–Z a–z 0–9 - _ . ! ~ * ' ( ) Referans: encodeURIComponent

encodeURIExtra: string (isteğe bağlı)

URI'yi düzenli ifade kullanarak değiştirmek için ek fonksiyon. Örneğin: ["%2F", "g", "\\%2F"]

userAgent: string (isteğe bağlı)

HTTP isteği için özel User-Agent dizesi.

sorguSeçici: string

HTML belgesindeki belirtilen seçiciye veya seçici grubuna uyan ilk öğeyi döndürür. Referans: querySelector

sorguSeçiciHepsi: string (isteğe bağlı)

Belirtilen seçici grubuna uyan HTML öğelerinin listesini temsil eden statik bir NodeList döndürür. Referans: querySelectorAll

sorguÖzelliği: string

Seçilen HTML öğesinden hangi özelliğin çıkarılacağını belirtir:

• "value" - HTMLDataElement özelliği [Reference]

• "innerText" - HTMLElement özelliği [Reference]

• "textContent" - Node özelliği [Reference]

• "innerHTML" - HTMLElement özelliği [Reference]

body: nesne

POST istekleri için istek gövdesi. İçinde gibi değişkenler olabilir $SOURCE_TEXT, $SOURCE_LANG, ve $TARGET_LANG.

options: nesne (isteğe bağlı)

Ek istek seçenekleri.

• headers - Özel istek üstbilgileri ayarlayın:

  • X-Custom-Header: string

  • Authorization: string

  • Content-Type: string

yanıtTürü: string

• "string" - yanıt türünü string olarak ayarla

• "json" - yanıt türünü json olarak ayarla

yanıtSorgusu: string

---

HTTP İsteklerinden JSON Yanıtlarını Ayrıştırma

JSON yanıtları şu kullanılarak ayrıştırılabilir responseQuery parametresi.

Şu responseQuery parametresi yalnızca için kullanılır http_get ve http_post yanıt türü olarak ayarlandığında yöntemler json.

İç içe JSON nesnelerinde gezinmek için alan adlarını ayırmak üzere nokta gösterimini (.) kullanın. Dizi öğelerine köşeli parantez gösterimi ile bir indeks kullanarak erişilebilir (ör. [0]).

Örnek JSON Yanıtı:

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

responseQuery	Sonuç
text	Hello 1
words[0].text	Hello 2
lines.sub.text	Hello 5

---

---

Örnekler

1. Web Kazıma Yöntemi

Gerekli Parametreler

• 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 Yöntemi

Gerekli Parametreler

• 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 Yöntemi

Gerekli Parametreler

• method: string ("http_post")

• url: string

• body: nesne

• options: nesne

  • headers: nesne

    • 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"
    }
}