Żądanie i odpowiedź

To jest sekcja konfiguracji Niestandardowy MT. Ta sekcja zawiera podstawową konfigurację dla żądań tłumaczenia maszynowego.

Zmienne

• $ID

• $SOURCE_TEXT lub $ORIGINAL_TEXT

• $TRANSLATED_TEXT

• $SOURCE_LANG

• $TARGET_LANG

Zmienne schematu można używać w konfiguracji za pomocą składni $SCHEMA_NAME.

Na przykład:

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

---

Parametry

method: string

• "web_scraping"

• "http_get"

• "http_post"

• "web_llm"

initialUrl: string (opcjonalnie)

Początkowy URL do odwiedzenia przed wykonaniem właściwego żądania (dla web scrapingu).

url: string

URL końcówki usługi tłumaczenia maszynowego.

encodeURI: boolean (opcjonalnie)

Ucieka znaki używając jednostek kodu UTF-8, przy czym każdy oktet kodowany jest w formacie %XX, uzupełniony z lewej strony zerem jeśli to konieczne. Pojedyncze surrogaty w UTF-16 nie kodują żadnego prawidłowego znaku Unicode. Odniesienie: encodeURI

encodeURIComponent: boolean (opcjonalnie)

Używa tego samego algorytmu kodowania co encodeURI. Ucieka wszystkie znaki z wyjątkiem: A–Z a–z 0–9 - _ . ! ~ * ' ( ) Odniesienie: encodeURIComponent

encodeURIExtra: string (opcjonalnie)

Dodatkowa funkcja do zamiany URI przy użyciu wyrażenia regularnego. Na przykład: ["%2F", "g", "\\%2F"]

userAgent: string (opcjonalnie)

Niestandardowy ciąg User-Agent dla żądania HTTP.

querySelector: string

Zwraca pierwszy element w dokumencie HTML, który pasuje do określonego selektora lub grupy selektorów. Odniesienie: querySelector

querySelectorAll: string (opcjonalnie)

Zwraca statyczną listę NodeList reprezentującą listę elementów HTML, które pasują do określonej grupy selektorów. Odniesienie: querySelectorAll

queryProperty: string

Określa, którą właściwość wyodrębnić z wybranego elementu HTML:

• "value" - właściwość HTMLDataElement [Odniesienie]

• "innerText" - właściwość HTMLElement [Odniesienie]

• "textContent" - właściwość Node [Odniesienie]

• "innerHTML" - właściwość HTMLElement [Odniesienie]

body: obiekt

Treść żądania dla żądań POST. Może zawierać zmienne takie jak $SOURCE_TEXT, $SOURCE_LANG, oraz $TARGET_LANG.

options: obiekt (opcjonalnie)

Dodatkowe opcje żądania.

• headers - Ustaw niestandardowe nagłówki żądania:

  • X-Custom-Header: string

  • Authorization: string

  • Content-Type: string

responseType: string

• "string" - ustaw typ odpowiedzi jako string

• "json" - ustaw typ odpowiedzi jako json

responseQuery: string

---

Parsowanie odpowiedzi JSON z żądań HTTP

Odpowiedzi JSON można parsować przy użyciu responseQuery parametru.

Jest używana do wyświetlania awatarów postaci głosowych i odtwarzania próbek audio bezpośrednio w VNTranslator. Jeśli pole pozostanie puste, awatary i podgląd audio nie będą dostępne. responseQuery parametr jest używany tylko dla http_get i http_post metod gdy typ odpowiedzi ustawiony jest na json.

Aby poruszać się po zagnieżdżonych obiektach JSON, użyj notacji kropkowej (.) do oddzielania nazw pól. Elementy tablic można uzyskać używając notacji z nawiasami i indeksem (np., [0]).

Przykładowa odpowiedź JSON:

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

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

---

---

Przykłady

1. Metoda web scrapingu

Wymagane parametry

• 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. Metoda HTTP GET

Wymagane parametry

• 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. Metoda HTTP POST

Wymagane parametry

• method: string ("http_post")

• url: string

• body: obiekt

• options: obiekt

  • headers: obiekt

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