OpenAPI로고
API소개
API가이드
API메뉴얼 다운로드
API가이드
 
 
통합검색
1. 자료검색

1.1 요청 변수 (request parameter)

요청변수 설명
  page   Integer(필수)   페이지
  search_field1   String(필수) - 기본값 : total_field   검색조건1
  value1   String(필수)   검색어1
  and_or_not1   String : AND/OR/NOT   검색어 연결조건1
  search_field2   String   검색조건2
  value2   String   검색어2
  and_or_not2   String : AND/OR/NOT   검색어 연결조건2
  search_field3   String   검색조건3
  value3   String   검색어3
  and_or_not3   String : AND/OR/NOT   검색어 연결조건3
  search_field4   String   검색조건4
  value4   String   검색어4
  and_or_not4   String : AND/OR/NOT   검색어 연결조건4
  search_field5   String   검색조건5
  value5   String   검색어5
  gubun1   String   표준부호
  code1   String   표준부호 값
  gubun2   String   분류기호
  code2   String   분류기호 값
  start_year   Integer   발행년도 시작
  end_year   Integer   발행년도 끝
  maxCount   String   최대검색건수
  sort_ksj   String   정렬조건
  hanja_trans   String (null / Y)   한자한글변환
  per_page   Integer(필수)   쪽당출력건수
  ※샘플URL
https://www.nl.go.kr/korcis/openApi/open.php?page=1&search_field1=total_field&and_or_not1=NOT&value1=%EA%B9%80%ED%95%B4%EA%B9%80%EC%94%A8&maxCount=1000&per_page=10
1.2 출력 결과 필드수(response field)

출력항목 설명
  METADATA      루트 엘리먼트
  TOTAL      검색건수
  RECORD      검색 결과 컨테이너(레코드 수만큼 반복)
  NUMBER   Integer   출력리스트 번호
  TITLE   String   서명
  AUTHOR   String   저자
  PUBLISHER   String   발행자
  PUBYEAR   String   발행년도
  TYPE   String   자료유형
  CONTENTS   String   목차유부
  LIB_NAME   String   도서관명
  LIB_CODE   String   도서관부호
  REC_KEY   Integer   서지정보 키
2. 상세보기

2.1 요청 변수 (request parameter)

요청변수 설명
  rec_key   Integer(필수)   고유키
  ※샘플URL
https://www.nl.go.kr/korcis/openApi/open.php?rec_key=101147081
2.2 출력 결과 필드수(response field)

출력항목 설명
  METADATA      루트 엘리먼트
  BIBINFO      서지항목(레코드 1건)
  TITLE_INFO   String   표제책임표시사항
  EDITION_INFO   String   판사항
  CARTOGRAPHIC_INFO   String   자료특성사항
  PUBLISH_INFO   String   발행사항
  FORM_INFO   String   형태사항
  SERIES_INFO   String   총서사항
  NOTE_INFO   String   서지 주기사항
  STANDARD_INFO   String   표준번호/부호
  CLASSFY_INFO   String   분류기호
  CONTENTS_YN   String   목차유무
  ABSTRACTS_YN   String   초록유무
  COVER_YN   String   표지유무
  UB_CONTROL_NO   String   UB제어번호
  ORIGINAL_YN   String   원문유무
  COPYRIGHT_YN   String   저작권유무
  LOCAL_CONTROL_NO   String   로컬제어번호
  ISBN   String   ISBN
  PRICE_INFO   String   가격
  HOLDINFO      소장정보 컨테이너(레코드수만큼 반복)
  NUMBER   String   출력리스트 번호
  LOCAL   String   소장도서관 지역 정보
  LIB_CODE   String   소장도서관 부호
  LIB_NAME   String   소장도서관 이름
  CALL_NO   String   서지 청구기호
  START_VOL   String   서지 시작 권호
  ORIGINAL_YN   String   원문유무
3. 원문자료검색

3.1 요청 변수 (request parameter)

요청변수 설명
  page   Integer(필수)   페이지
  search_field1   String(필수) - 기본값 : total_field   검색조건1
  value1   String(필수)   검색어1
  and_or_not1   String : AND/OR/NOT   검색어 연결조건1
  search_field2   String   검색조건2
  value2   String   검색어2
  and_or_not2   String : AND/OR/NOT   검색어 연결조건2
  search_field3   String   검색조건3
  value3   String   검색어3
  and_or_not3   String : AND/OR/NOT   검색어 연결조건3
  search_field4   String   검색조건4
  value4   String   검색어4
  and_or_not4   String : AND/OR/NOT   검색어 연결조건4
  search_field5   String   검색조건5
  value5   String   검색어5
  gubun1   String   표준부호
  code1   String   표준부호 값
  gubun2   String   분류기호
  code2   String   분류기호 값
  start_year   Integer   발행년도 시작
  end_year   Integer   발행년도 끝
  maxCount   String   최대검색건수
  sort_ksj   String   정렬조건
  original_yn   String(null / Y)   원문유무
  hanja_trans   String (null / Y)   한자한글변환
  per_page   Integer(필수)   쪽당출력건수
  ※샘플URL
https://www.nl.go.kr/korcis/openApi/openOrigin.php?page=1&search_field1=total_field&and_or_not1=NOT&value1=%EA%B9%80%ED%95%B4%EA%B9%80%EC%94%A8&maxCount=1000&per_page=10
3.2 출력 결과 필드수(response field)

출력항목 설명
  METADATA      루트 엘리먼트
  TOTAL      검색건수
  LINK      검색결과페이지링크
  RECORD      검색 결과 컨테이너(레코드 수만큼 반복)
  NUMBER   Integer   출력리스트 번호
  TITLE   String   서명
  AUTHOR   String   저자
  PUBLISHER   String   발행자
  PUBYEAR   String   발행년도
  TYPE   String   자료유형
  CONTENTS   String   목차유부
  LIB_NAME   String   도서관명
  LIB_CODE   String   도서관부호
  REC_KEY   Integer   서지정보 키
copyright