---
title: "동의어 사전 설정"
slug: "analytics-cloudsearch-postsynonym"
updated: 2026-04-23T08:56:10Z
published: 2026-04-23T09:02:33Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 동의어 사전 설정

사용자 동의어 사전을 설정합니다.

- 사용자가 원하는 단어를 동의어로 설정하여 검색할 수 있습니다.
- 현재 동의어 사전은 하나만 설정이 가능하며, 버전으로 관리할 수 있습니다.
- 동의어는 콤마(,)로 단어 구분은 줄바꿈으로 구분하여 입력해 주세요.

```
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/synonym
```

## 요청

### 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string |  | 생성되어져 있는 Domain 이름 |

### 요청 바디

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 영문, "_"로 시작, 영문, 숫자, "_" 허용 최소 3자 최대 20자까지 입력 | 생성할 동의어 사전 이름 |
| description | Yes | string | 0 ~ 100자까지 입력 | 생성할 동의어 사전에 대한 설명 |
| wordList | Yes | string |  | 동의어로 설정할 단어 목록 |
| version | Yes | string |  | 생성할 동의어 사전의 버전 |

### 응답 Status

| HTTP Status | Desc |
| --- | --- |
| 200 | OK(생성 완료) |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |

## 예시

### 요청 예시

```
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/wiki/synonym
Content-Type: application/json
x-ncp-iam-access-key: cPMl0CYGgRYvEa8sylCj
x-ncp-apigw-signature-v2: +Ln++MqcKHckKli2y/bB76xLUu8qR9rLvo6j2yIYuYg=
x-ncp-apigw-timestamp: 1551453306138

{
  "name": "syno",
  "description": "wiki 동의어 사전",
  "wordList": "현대,횬대\n아우디,아오디",
  "version": "0.1"
}
```

### 응답 예시

```
{"result":"ok"}
```