요청 및 응답

이것은 구성 섹션입니다 사용자 정의 MT. 이 섹션에는 기계 번역 요청을 위한 핵심 구성 설정이 포함되어 있습니다.

변수

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

---

매개변수

메서드: 문자열

• "web_scraping"

• "http_get"

• "http_post"

• "web_llm"

초기 URL: 문자열 (선택 사항)

실제 요청을 하기 전에 방문할 초기 URL(웹 스크래핑용).

url: 문자열

기계 번역 서비스의 엔드포인트 URL.

encodeURI: 부울 (선택 사항)

UTF-8 코드 단위를 사용하여 문자를 이스케이프하며, 각 옥텟은 형식으로 인코딩됩니다 %XX, 필요 시 0으로 왼쪽 채움됩니다. UTF-16의 고립된 대리코드는 유효한 유니코드 문자를 인코드하지 않습니다. 참조: encodeURI

encodeURIComponent: 부울 (선택 사항)

다음과 동일한 인코딩 알고리즘을 사용합니다 encodeURI. 다음을 제외한 모든 문자를 이스케이프합니다: A–Z a–z 0–9 - _ . ! ~ * ' ( ) 참조: encodeURIComponent

encodeURIExtra: 문자열 (선택 사항)

정규식을 사용하여 URI를 교체하는 추가 함수입니다. 예: ["%2F", "g", "\\%2F"]

userAgent: 문자열 (선택 사항)

HTTP 요청을 위한 사용자 지정 User-Agent 문자열.

querySelector: 문자열

문서 내에서 지정된 선택자 또는 선택자 그룹과 일치하는 첫 번째 요소를 반환합니다. 참조: querySelector

querySelectorAll: 문자열 (선택 사항)

지정된 선택자 그룹과 일치하는 HTML 요소 목록을 나타내는 정적 NodeList를 반환합니다. 참조: querySelectorAll

queryProperty: 문자열

선택된 HTML 요소에서 추출할 속성을 지정합니다:

• "value" - HTMLDataElement의 속성 [참조]

• "innerText" - HTMLElement의 속성 [참조]

• "textContent" - Node의 속성 [참조]

• "innerHTML" - HTMLElement의 속성 [참조]

body: 객체

POST 요청의 요청 본문입니다. 같은 변수들을 포함할 수 있습니다 $SOURCE_TEXT, $SOURCE_LANG, 그리고 $TARGET_LANG.

options: 객체 (선택 사항)

추가 요청 옵션.

• headers - 사용자 지정 요청 헤더 설정:

  • X-Custom-Header: 문자열

  • Authorization: 문자열

  • Content-Type: 문자열

responseType: 문자열

• "string" - 응답 유형을 문자열로 설정

• "json" - 응답 유형을 json으로 설정

responseQuery: 문자열

---

HTTP 요청의 JSON 응답 파싱

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. 웹 스크래핑 방법

필수 매개변수

• 메서드: 문자열 ("web_scraping")

• URL: 문자열

• querySelector: 문자열

• queryProperty: 문자열

{
    "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 방법

필수 매개변수

• 메서드: 문자열 ("http_get")

• URL: 문자열

• responseType: 문자열

• responseQuery: 문자열

{
    "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 방법

필수 매개변수

• 메서드: 문자열 ("http_post")

• URL: 문자열

• 본문: 객체

• 옵션: 객체

  • headers: 객체

    • X-Custom-Header: string

    • Authorization: string

    • Content-Type: string

• responseType: 문자열

• responseQuery: 문자열

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