자동 완성 설정 이후 해당 요청을 사용할 수 있습니다.
요청한 검색어의 자동 완성 색인을 검색합니다.
GET, POST 요청을 지원하며, 두 요청이 동일하여 선택적으로 이용할 수 있습니다.
GET Request
GET https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/{name}/document/search/autocomplete
요청
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|
| name | Yes | string | 검색 설정이 되어 있는 도메인 | 검색하고자 하는 도메인 이름 |
| type | Yes | string | term, section | 검색하고자 하는 타입
term: 색인 단위의 자동 완성 검색section: 섹션 단위의 자동 완성 검색 |
| query | Yes | string | | 검색어 |
응답
응답 바디
| 필드명 | 필수 여부 | 타입 | 설명 | 비고 |
|---|
| type | Yes | string | 자동 완성 검색 요청 타입 | |
| item_count | Yes | number | 자동 완성 검색 결과 개수 | |
| items | Yes | Array[string] | 자동 완성 검색 결과 | |
응답 Status
| HTTP Status | Desc |
|---|
| 200 | OK(검색 완료) |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |
예시
요청 예시
GET https://cloudsearch.apigw.gov-ntruss.com/cloudsearch/api/v1/domain/abcdef/document/search/autocomplete?type=section&query=%E3%85%8E
응답 예시
{
"type": "section",
"item_count": 1,
"items": [
"2018 토요타 캠리 하이브리드"
]
}
POST Request
POST https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/{name}/document/search/autocomplete
요청
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|
| name | Yes | string | 검색 설정이 되어 있는 도메인 | 검색하고자 하는 도메인 이름 |
요청 바디
응답
응답 바디
| 필드명 | 필수 여부 | 타입 | 설명 | 비고 |
|---|
| type | Yes | string | 자동 완성 검색 요청 타입 | |
| item_count | Yes | number | 자동 완성 검색 결과 개수 | |
| items | Yes | Array[string] | 자동 완성 검색 결과 | |
응답 Status
| HTTP Status | Desc |
|---|
| 200 | OK(검색 완료) |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |
예시
요청 예시
POST /CloudSearch/real/v1/domain/abcdef/document/search/autocomplete HTTP/1.1
Host: cloudsearch.apigw.gov-ntruss.com
accept:application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi
{
"query": "ㅎ",
"type": "term"
}
응답 예시
{
"type": "term",
"item_count": 2,
"items": [
"현대",
"하이브리드"
]
}
의견을 보내 주셔서 감사합니다! 우리 팀이 당신에게 돌아갈 것입니다.
