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 | ソース言語コード (例: ko、en) |
target |
String | Required | ターゲット言語コード (例: ko、en) |
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"
}
]
}