Subscription Form
Contributors
네이버 전문자료검색 OpenAPI를 사용해서 전문자료를 쉽고 편리하게 매칭하는 기능을 구현해봅니다.

1. 요청 URL (request url)

   http://openapi.naver.com/search

2. 요청 변수 (request parameter)
요청 변수 설명
key string (필수) 이용 등록을 통해 받은 key 스트링을 입력합니다.
target string (필수) : doc 서비스를 위해서는 무조건 지정해야 합니다.
query string (필수) 검색을 원하는 질의, UTF-8 인코딩 입니다.
display integer : 기본값 10, 최대 100 검색결과 출력건수를 지정합니다. 최대 100까지 가능합니다.
start integer : 기본값 1, 최대 1000 검색의 시작위치를 지정할 수 있습니다. 최대 1000까지 가능합니다.

샘플 URL

   http://openapi.naver.com/search?key=test&query=go&display=10&start=1&target=doc

3. 출력 결과 필드 (response field)
필드 설명
rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.
channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다.
lastBuildDate datetime 검색 결과를 생성한 시간입니다.
total integer 검색 결과 문서의 총 개수를 의미합니다.
start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다.
display integer 검색된 검색 결과의 개수입니다.
item 개별 검색 결과이며, title, link, description을 포함합니다.
title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다.
link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다.
description string 검색 결과 문서의 내용을 요약한 패시지 정보입니다. 문서 전체의 내용은 link 를 따라가면, 읽을 수 있습니다. 패시지에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다.

4. 비고/에러 메시지

000 : System error
시스템 에러

010 : Your query request count is over the limit
쿼리요청 제한을 초과하였습니다. 일반적으로는 5,000개이상의 쿼리에 대하여 이 에러 메세지가 발생되나, 쿼리 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.

011 : Incorrect query request
잘못된 쿼리요청입니다. 쿼리(query=)필드 자체가 없는 경우 발생하는 에러 메세지 입니다. …&query=& 식으로 입력하는 경우 정상적인 쿼리 요청으로 보고, 에러 메세지를 발생하지 않으며, “에 대한 검색을 수행합니다.
020 : Unregistered key
등록되지 않은 키입니다.
021 : Your key is temporary unavailable
사용할 수 없는 키입니다. OpenAPI에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 쿼리를 검색하는 경우 발생하는 에러입니다.
100 : Invalid target value
부적절한 target 값입니다. 필드 설명에 없는 target이름을 사용한 경우, 혹은 target필드가 없는 경우 발생하는 메세지입니다.
101 : Invalid display value
부적절한 display 값입니다. display필드 자체가 없는 경우에는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, 기본값인 display=10으로 처리됩니다. display값이 100을 초과하는 경우나 0이하의 값일때, 혹은 ‘…&display=&’와 같이 값을 입력하지 않은 경우에는 에러 메세지를 발생합니다.
102 : Invalid start value
부적절한 start 값입니다. start필드 자체가 없는 경우에는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, 기본값인 start=1으로 처리됩니다. start값이 1000을 초과하거나 0이하의 경우, 혹은 ‘…&start=&’와 같이 값을 입력하지 않은 경우에는 에러 메세지를 발생합니다.
110 : Undefined sort value
정의되지 않은 sort값입니다. sort필드 자체가 없는 경우는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, sort 옵션을 사용하는 서비스 API인 경우 기본값인 sort=sim으로 처리됩니다. sort값이 해당하는 서비스의 정렬옵션 이외의 값을 가지는 경우 혹은 ‘…&sort=&’와 같이 값을 입력하지 않은 경우 에러 메세지를 발생합니다. ( 예, 지식iN 검색 쿼리 요청에서 쇼핑 검색의 정렬 옵션인 sort=asc를 사용하는 경우 )
200 : Reserved
900 : Undefined error occured
정의되지 않은 오류가 발생하였습니다.

 

Total
0
Shares
1 comment
  1. 핑백: Self Control

댓글 남기기

이메일은 공개되지 않습니다. 필수 입력창은 * 로 표시되어 있습니다