네이버 전문자료검색 OpenAPI를 사용해서 전문자료를 쉽고 편리하게 매칭하는 기능을 구현해봅니다.
1. 요청 URL (request url)
http://openapi.naver.com/search 1. 요청 URL (request url)
2. 요청 변수 (request parameter)
| 요청 변수 | 값 | 설명 |
| key | string (필수) | 이용 등록을 통해 받은 key 스트링을 입력합니다. |
| target | string (필수) : doc | 서비스를 위해서는 무조건 지정해야 합니다. |
| query | string (필수) | 검색을 원하는 질의, UTF-8 인코딩 입니다. |
| display | integer : 기본값 10, 최대 100 | 검색결과 출력건수를 지정합니다. 최대 100까지 가능합니다. |
| start | integer : 기본값 1, 최대 1000 | 검색의 시작위치를 지정할 수 있습니다. 최대 1000까지 가능합니다. |
샘플 URL3. 출력 결과 필드 (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. 비고/에러 메시지
쿼리요청 제한을 초과하였습니다. 일반적으로는 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 정의되지 않은 오류가 발생하였습니다. |
댓글을 달아 주세요