신청·참여
활용방법
출판예정도서 자료 검색
사용설명출판예정도서 자료를 조회할 수 있는 기능을 제공합니다.
요청 URL(request url)https://www.nl.go.kr/NL/search/openApi/cip.do
요청 변수(request parameter)※단,검색조건 및 맵핑되는 검색어가 하나이상 포함되어야 함
NO | 요청변수 | 형식 | 설명 |
---|---|---|---|
1 | key | String(필수) |
발급키 |
2 | srchTarget | String |
total (전체) title (제목), author (저자) publisher (발행자), 생략시 전체 |
3 | kwd | String |
검색어 |
4 | pageNum | Integer(필수) |
현재페이지 |
5 | pageSize | Integer(필수) |
쪽당출력건수 (기본 10건) |
6 | sort | String |
[정렬 (생략시 : 정확도순)] ititle (제목) iauthor (저자) ipublisher (발행처) ipub_year (발행년도)cheonggu (청구기호) |
7 | desc | String | asc (오름차순) desc (내림차순) |
8 | apiType | String |
xml json |
9 | searchType | String |
GB(group By) 일반검색 |
"정보"를 검색할 경우 : https://www.nl.go.kr/NL/search/openApi/cip.do?key=[발급된키값]&kwd=%EC%A0%95%EB%B3%B4&apiType=xml&searchType=&sort=
※ URL(한글)은 반드시 인코딩해야 함
출력결과 필드 (response field)NO | 필드 | 값 | 설명 |
---|---|---|---|
1 | kwd | - | 검색어 |
2 | category | - | 카테고리 |
3 | pageNum | - | 현재페이지 |
4 | pageSize | - | 쪽당출력건수 (기본 10건) |
5 | sort | - | 정렬 |
6 | total | - | 검색건수 |
7 | Id | - | CIP키 |
8 | kdc_code_1s | - | 한국십진분류법 대분류 코드 |
9 | title_info | - | 표제 리스트 |
10 | author_info | - | 저작자 |
11 | pub_info | - | 발행자 |
12 | exp_date | - | 출판예정일 |
13 | cover_yn | - | 섬네일 유무 |
14 | thumb_path | - | 섬네일 Path |
15 | thumb_file_name | - | 섬네일 파일명 |
16 | img_path | - | 섬네일 이미지 경로 |
17 | detail_path | - | 상세페이지 링크 |
18 | price | - | 가격 |
19 | currency_code | - | 화폐단위 |
20 | isbn | - | ISBN |
21 | title_page_yn | - | 표제지 유무 |
22 | copyright_page_yn | - | 판권지 유무 |
23 | author_yn | - | 저자관련정보 유무 |
24 | preface_yn | - | 서문 유무 |
25 | contents_yn | - | 목차 유무 |
26 | abstract_yn | - | 요약/초록 유무 |
27 | text_yn | - | 본문 유무 |
28 | etc_yn | - | 기타 유무 |
29 | publisher_key | - | 출판사키 |
30 | ea_add_code | - | EA ISBN부가기호 |
※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다. 에러메시지
에러코드 | 설명 |
---|---|
000 | SYSTEM ERROR:SYSTEM 오류 |
010 | NO KEY VALUE:인증키값 누락 |
011 | INVALID KEY:유효하지않은 인증키 |
015 | REQUIRED PARAMETER MISSING:필수 파라메터 입력 오류(검색어) |
101 | SEARCH ERROR:검색서버 오류 |