Richiesta e risposta

Questa è una sezione di configurazione di MT Personalizzato. Questa sezione contiene la configurazione principale per le richieste di Traduzione Automatica.

Variabili

• $ID

• $SOURCE_TEXT o $ORIGINAL_TEXT

• $TRANSLATED_TEXT

• $SOURCE_LANG

• $TARGET_LANG

Le variabili dello schema possono essere utilizzate nella configurazione con la sintassi $SCHEMA_NAME.

Per esempio:

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

---

Parametri

method: stringa

• "web_scraping"

• "http_get"

• "http_post"

• "web_llm"

initialUrl: stringa (opzionale)

L'URL iniziale da visitare prima di effettuare la richiesta effettiva (per il web scraping).

url: stringa

L'URL endpoint per il servizio di Traduzione Automatica.

encodeURI: booleano (opzionale)

Esegue l'escape dei caratteri usando unità di codice UTF-8, con ogni ottetto codificato nel formato %XX, completato a sinistra con 0 se necessario. I surrogate singoli in UTF-16 non codificano alcun carattere Unicode valido. Riferimento: encodeURI

encodeURIComponent: booleano (opzionale)

Utilizza lo stesso algoritmo di codifica di encodeURI. Esegue l'escape di tutti i caratteri tranne: A–Z a–z 0–9 - _ . ! ~ * ' ( ) Riferimento: encodeURIComponent

encodeURIExtra: stringa (opzionale)

Funzione aggiuntiva per sostituire parti dell'URI usando un'espressione regolare. Per esempio: ["%2F", "g", "\\%2F"]

userAgent: stringa (opzionale)

Stringa User-Agent personalizzata per la richiesta HTTP.

querySelector: stringa

Restituisce il primo elemento all'interno del documento HTML che corrisponde al selettore specificato o al gruppo di selettori. Riferimento: querySelector

querySelectorAll: stringa (opzionale)

Restituisce una NodeList statica che rappresenta un elenco di elementi HTML che corrispondono al gruppo di selettori specificato. Riferimento: querySelectorAll

queryProperty: stringa

Specifica quale proprietà estrarre dall'elemento HTML selezionato:

• "value" - proprietà dell'HTMLDataElement [Riferimento]

• "innerText" - proprietà dell'HTMLElement [Riferimento]

• "textContent" - proprietà del Node [Riferimento]

• "innerHTML" - proprietà dell'HTMLElement [Riferimento]

body: oggetto

Il corpo della richiesta per le richieste POST. Può contenere variabili come $SOURCE_TEXT, $SOURCE_LANG, e $TARGET_LANG.

options: oggetto (opzionale)

Opzioni aggiuntive per la richiesta.

• headers - Imposta intestazioni di richiesta personalizzate:

  • X-Custom-Header: stringa

  • Authorization: stringa

  • Content-Type: stringa

responseType: stringa

• "string" - imposta il tipo di risposta come stringa

• "json" - imposta il tipo di risposta come json

responseQuery: stringa

---

Parsing delle risposte JSON dalle richieste HTTP

Le risposte JSON possono essere analizzate usando il responseQuery parametro.

Il responseQuery Il parametro è usato solo per http_get e http_post metodi quando il tipo di risposta è impostato su json.

Per navigare attraverso oggetti JSON nidificati, usa la notazione a punti (.) per separare i nomi dei campi. Gli elementi degli array possono essere accessi usando la notazione con parentesi quadre e un indice (es., [0]).

Esempio di risposta JSON:

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

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

---

---

Esempi

1. Metodo di Web Scraping

Parametri obbligatori

• method: stringa ("web_scraping")

• url: stringa

• querySelector: stringa

• queryProperty: stringa

{
    "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. Metodo HTTP GET

Parametri obbligatori

• method: stringa ("http_get")

• url: stringa

• responseType: stringa

• responseQuery: stringa

{
    "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. Metodo HTTP POST

Parametri obbligatori

• method: stringa ("http_post")

• url: stringa

• body: oggetto

• options: oggetto

  • headers: oggetto

    • X-Custom-Header: string

    • Authorization: string

    • Content-Type: string

• responseType: stringa

• responseQuery: stringa

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