---
title: "동의어 사전 설정"
slug: "analytics-cloudsearch-postsynonym"
updated: 2026-09-17T09:16:04Z
published: 2026-09-17T09:16:04Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-postsynonym"
---

> ## 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.

# 동의어 사전 설정

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

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

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

## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

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

### 요청 바디<a name="요청바디"></a>

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

### 응답 Status<a name="응답Status"></a>

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


## 예시<a name="예시"></a>


### 요청 예시<a name="요청예시"></a>

```http
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"
}
```

### 응답 예시<a name="응답예시"></a>


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