Requête et réponse

Ceci est une section de configuration de MT personnalisé. Cette section contient la configuration principale pour les requêtes de traduction automatique.

Variables

• $ID

• $SOURCE_TEXT ou $ORIGINAL_TEXT

• $TRANSLATED_TEXT

• $SOURCE_LANG

• $TARGET_LANG

Les variables du schéma peuvent être utilisées dans la configuration avec la syntaxe $SCHEMA_NAME.

Par exemple :

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

---

Paramètres

méthode: chaîne

• "web_scraping"

• "http_get"

• "http_post"

• "web_llm"

initialUrl: chaîne (optionnel)

L'URL initiale à visiter avant d'effectuer la requête réelle (pour le web scraping).

url: chaîne

L'URL de point de terminaison pour le service de traduction automatique.

encodeURI: booléen (optionnel)

Échappe les caractères en utilisant les unités de code UTF-8, chaque octet étant encodé au format %XX, rempli à gauche avec 0 si nécessaire. Les substituts isolés en UTF-16 n'encodent aucun caractère Unicode valide. Référence : encodeURI

encoderComposantURI : booléen (optionnel)

Utilise le même algorithme d'encodage que encodeURI. Échappe tous les caractères sauf : A–Z a–z 0–9 - _ . ! ~ * ' ( ) Référence : encodeURIComponent

encodeURIExtra : chaîne (optionnel)

Fonction supplémentaire pour remplacer l'URI en utilisant une expression régulière. Par exemple : ["%2F", "g", "\\%2F"]

userAgent : chaîne (optionnel)

Chaîne User-Agent personnalisée pour la requête HTTP.

querySelector : chaîne

Retourne le premier élément dans le document HTML qui correspond au sélecteur spécifié ou au groupe de sélecteurs. Référence : querySelector

querySelectorAll : chaîne (optionnel)

Retourne une NodeList statique représentant une liste d'éléments HTML qui correspondent au groupe de sélecteurs spécifié. Référence : querySelectorAll

propriétéQuery : chaîne

Spécifie quelle propriété extraire de l'élément HTML sélectionné :

• "value" - propriété de HTMLDataElement [Référence]

• "innerText" - propriété de l'HTMLElement [Référence]

• "textContent" - propriété du Node [Référence]

• "innerHTML" - propriété de l'HTMLElement [Référence]

body : objet

Le corps de la requête pour les requêtes POST. Peut contenir des variables comme $SOURCE_TEXT, $SOURCE_LANG, et $TARGET_LANG.

options : objet (optionnel)

Options supplémentaires de la requête.

• headers - Définir des en-têtes de requête personnalisés :

  • X-Custom-Header : chaîne

  • Authorization : chaîne

  • Content-Type : chaîne

responseType : chaîne

• "string" - définir le type de réponse comme chaîne

• "json" - définir le type de réponse comme json

responseQuery : chaîne

---

Analyse des réponses JSON des requêtes HTTP

Les réponses JSON peuvent être analysées en utilisant le responseQuery paramètre.

Le responseQuery Le paramètre est utilisé uniquement pour http_get et http_post méthodes lorsque le type de réponse est défini sur json.

Pour naviguer dans des objets JSON imbriqués, utilisez la notation par points (.) pour séparer les noms de champs. Les éléments de tableau peuvent être accédés en utilisant la notation entre crochets avec un index (par ex., [0]).

Exemple de réponse JSON :

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

responseQuery	Résultat
text	Hello 1
words[0].text	Hello 2
lines.sub.text	Hello 5

---

---

Exemples

1. Méthode de web scraping

Paramètres requis

• méthode: chaîne ("web_scraping")

• url: chaîne

• querySelector: chaîne

• queryProperty: chaîne

{
    "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. Méthode HTTP GET

Paramètres requis

• méthode: chaîne ("http_get")

• url: chaîne

• responseType: chaîne

• responseQuery: chaîne

{
    "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. Méthode HTTP POST

Paramètres requis

• méthode: chaîne ("http_post")

• url: chaîne

• corps: objet

• options: objet

  • headers: objet

    • X-Custom-Header: string

    • Authorization: string

    • Content-Type: string

• responseType: chaîne

• responseQuery: chaîne

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