用語の追加

Prev Next

Classic/VPC環境で利用できます。

用語集に新しい用語を追加します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /glossary/v1/replacer

リクエストヘッダ

Papago Translation APIで共通して使用されるヘッダの詳細は、Papago Translationの共通ヘッダをご参照ください。

リクエストボディ

追加する用語(Replacer)リストを渡します。1つのリクエストにつき最大20件まで登録できます。

フィールド タイプ 必須の有無 説明
replacers Array Required 追加する用語リスト (最大20個): replacers

replacers

リクエストボディのreplacers配列内の各用語登録項目を定義します。

フィールド タイプ 必須の有無 説明
glossaryKey String Required 用語集 ID
source String Required ソース言語コード (例: koen)
target String Required ターゲット言語コード (例: koen)
triggerText String Required 原文テキスト
replaceText String Required 翻訳テキスト

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST "https://papago.apigw.ntruss.com/glossary/v1/replacer" \
  --header "Content-Type: application/json" \
  --header "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}" \
  --header "x-ncp-iam-access-key: {x-ncp-iam-access-key}" \
  --header "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}" \
  --data '{
    "replacers": [
      {
        "glossaryKey": "7f3c2a91-8b5e-4d7b-9e32-1c0f4e7e59ad",
        "source": "ko",
        "target": "en",
        "triggerText": "テスト用語1",
        "replaceText": "Test Term 1"
      },
      {
        "glossaryKey": "7f3c2a91-8b5e-4d7b-9e32-1c0f4e7e59ad",
        "source": "ko",
        "target": "en",
        "triggerText": "テスト用語2",
        "replaceText": "Test Term 2"
      }
    ]
  }'
 

レスポンス

レスポンス形式を説明します。

レスポンスボディ

replacerList (Array)のレスポンスボディの説明は次の通りです。

フィールド タイプ 説明
id Long 用語 ID
glossaryKey String 用語集 ID
source String ソース言語コード (例: "ko"、"en")
target String ターゲット言語コード (例: "ko"、"en")
triggerText String 原文テキスト
replaceText String 翻訳テキスト
createdDateTime String 作成日時 (yyyy-MM-dd kk:mm:ss)

レスポンスステータスコード

Papago Translation APIで共通して使用されるレスポンスステータスコードの詳細は、Papago Translationの共通レスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "replacers": [
        {
            "id": 12345,
            "glossaryKey": "7f3c2a91-8b5e-4d7b-9e32-1c0f4e7e59ad",
            "source": "ko",
            "target": "en",
            "triggerText": "テスト用語",
            "replaceText": "Test Term",
            "createdDateTime": "2025-01-24 10:30:00"
        }
    ]
}