자동완성

사용자가 검색어의 일부만 입력해도 입력한 문자가 포함된 다양한 검색어들을 추천하는 기능입니다.

요청 URL

http://host:port/ksf/api/suggest

요청 변수

요청 변수 값 설명 테스트
target string (필수): complete 서비스를 위해 반드시 지정해야 합니다.
domain_no number (선택)

검색할 도메인 번호

지정하지 않을 경우 0번 도메인을 검색합니다.
term string (필수) 자동완성할 검색어 힌트
mode string (선택)

자동완성 검색어 추천 방식

첫 단어 일치(s:starts with), 끝 단어 일치(e:ends with), 공백 기준의 가운데 단어 일치(c:contains), 단어 기반 일치(t:token) 중 필요한 방식들을 조합하여 지정합니다. 지정하지 않을 경우 첫 단어가 일치(s)하는 검색어들을 추천합니다.
max_count number (선택)

추천받을 검색어의 최대 개수

지정하지 않을 경우 최대 10개의 검색어들을 추천합니다.
use_spc boolean (선택)

자동완성 전용 오타교정 모듈을 사용할지 여부

자동완성 전용 오타교정 모듈이 활성화 되어 있을경우 오타를 교정하여 검색어를 추천합니다. 
http://host:port/ksf/api/suggest?target=complete&domain_no=0&term=zhsks&mode=s&max_count=10
Test

출력 결과 필드

필드 값 설명
seed string 입력 문자열. 한/영 키를 잘못 설정하고 검색했을 경우 키 변환된 검색어를 반환합니다.
suggestions array 입력 문자열을 포함하는 자동완성 검색어 및 관련 정보들을 배열로 반환합니다. 결과가 없으면 빈 배열이 반환됩니다. 
{seed:"코난", suggestions:[["코난", "http://www.konantech.com"], ["코난 소셜 크롤러", "http://www.konantech.com/?c=product&m=socialcrawler", "101"], ["코난 웹 크롤러", "http://www.konantech.com/?c=product&m=webcrawler", "102"], ["코난 커넥터"], ["코난 텍스트 분류기", "http://www.konantech.com/?c=product&m=classifier"], ["코난 텍스트 애널리틱스"], ["코난 로그 애널리틱스"], ["코난 서치 4"], ["코난 독크루저"], ["코난 밈체커"]]}

인기 검색어

이용자들이 가장 많이 입력한 검색어들을 추천하는 기능입니다.

요청 URL

http://host:port/ksf/api/rankings

요청 변수

요청 변수 값 설명 테스트
domain_no number (선택)

검색할 도메인 번호

지정하지 않을 경우 0번 도메인을 검색합니다.
max_count number (선택)

추천받을 검색어의 최대 개수

지정하지 않을 경우 최대 10개의 검색어들을 추천합니다. 
http://host:port/ksf/api/rankings?domain_no=0
Test

출력 결과 필드

필드 값 설명
- string 검색어
- string 변동 순위 
[["코난","new"],["날씨","-1"],["부동산","3"],["펀드","5"],["여행","0"],["휴가","152"],["영화","-11"],["드라마","14"],["지하철","10"],["스키장","new"]]

추천 검색어

사용자가 입력한 검색어와 연관도가 높은 검색어들을 추천합니다.

요청 URL

http://host:port/ksf/api/suggest

요청 변수

요청 변수 값 설명 테스트
target string (필수): related 서비스를 위해 반드시 지정해야 합니다.
domain_no number (선택)

검색할 도메인 번호

지정하지 않을 경우 0번 도메인을 검색합니다.
term string (필수) 검색을 원하는 질의어
max_count number (선택)

추천받을 검색어의 최대 개수

지정하지 않을 경우 최대 10개의 검색어들을 추천합니다. 
http://host:port/ksf/api/suggest?target=related&term=gatsby
Test

출력 결과 필드

필드 값 설명
- string array 입력한 검색어와 연관도가 높은 검색어들을 배열로 반환합니다. 결과가 없으면 빈 배열이 반환됩니다. 
["the great gatsby", "gatsby cm", "gatsby wax"]

오타 교정

맞춤법에 맞지 않는 검색어를 입력했을 경우 입력하신 검색어를 자동으로 변환/추천해 주는 기능입니다.

요청 URL

http://host:port/ksf/api/suggest

요청 변수

요청 변수 값 설명 테스트
target string (필수): spell 서비스를 위해 반드시 지정해야 합니다.
term string (필수) 검색을 원하는 질의어 
http://host:port/ksf/api/suggest?target=spell&term=milion
Test

출력 결과 필드

필드 값 설명
- string array 오타 교정 결과 추천된 검색어들을 배열로 반환합니다. 결과가 없으면 빈 배열이 반환됩니다. 
["million","milian","mullion","malian","melon"]

금칙어

입력문의 금칙어 여부를 판단하여 금칙어일 경우 해당 금칙어들을 반환한다.

요청 URL

http://host:port/ksf/api/censored

요청 변수

요청 변수 값 설명 테스트
domain_no number (선택)

검색할 도메인 번호

지정하지 않을 경우 0번 도메인을 검색합니다.
term string (필수) 검색을 원하는 질의어 
http://host:port/ksf/api/censored?domain_no=0&term=adult+sex+movie+film
Test

출력 결과 필드

필드 값 설명
- string array 금칙어로 등록된 문자열들을 배열로 반환합니다. 결과가 없으면 빈 배열이 반환됩니다. 
["adult", "sex"]

실시간 인기 검색어

이용자들이 가장 많이 입력한 검색어들을 실시간으로 추천하는 기능입니다.

요청 URL

http://host:port/ksf/api/rankings

요청 변수

요청 변수 값 설명 테스트
realtime boolean (필수): true 서비스를 위해 반드시 지정해야 합니다.
domain_no number (선택)

검색할 도메인 번호

지정하지 않을 경우 0번 도메인을 검색합니다.
max_count number (선택)

추천받을 검색어의 최대 개수

지정하지 않을 경우 최대 10개의 검색어들을 추천합니다. 
http://host:port/ksf/api/rankings?realtime=true&domain_no=0
Test

출력 결과 필드

필드 값 설명
- string 검색어
- string 변동 순위 
[["스티브잡스","new"],["코난","5"],["테크놀로지","new"],["애플","-1"]]

한자 독음

입력 받은 텍스트 내에 있는 모든 한자를 한글 독음으로 치환하는 기능입니다.

요청 URL

http://host:port/ksf/api/convert

요청 변수

요청 변수 값 설명 테스트
domain_no number (선택)

검색할 도메인 번호

지정하지 않을 경우 시스템 도메인을 검색합니다.
term string (필수) 변환을 원하는 문장 
http://host:port/ksf/api/convert?term=漢字+한글+變換+프로그램+試驗을+위한+文書입니다.
Test

출력 결과 필드

필드 값 설명
- string 한글 독음으로 치환된 문자열 
한자 한글 변환 프로그램 시험을 위한 문서입니다.