Open API
검색
사용설명
- 국가전자도서관에서 수집된 자료의 검색 기능을 제공합니다.
요청 URL(request url)
- http://www.dlibrary.go.kr/openapi/call.do?요청변수=값
요청 변수(request parameter)
| No | 요청변수 | 값 | 설명 |
|---|---|---|---|
| 1 | dist_key | String(필수) | 발급키 |
| 2 | func_id | String(필수, 고정) | 3 |
| 3 | sw | String(필수) | 검색어 |
| 4 | pg | Integer | 현재페이지 |
| 5 | cntPerPage | Integer | 쪽당출력건수 (기본 10건) |
| 6 | sf | String |
검색조건 전체 [] 제목 [title] 저자 [author] 발행자 [publisher] |
| 7 | of | String |
정렬필드 제목 [sorted_tltle] 저자 [sorted_author] 발행처 [sorted_publisher] 발행연도 [pub_year] |
| 8 | os | String |
정렬조건 오름차순 [asc] 내림차순 [desc] |
| 9 | file_yn | String |
검색조건 원문있음 [y] 원문없음 [n] |
샘플 URL
- "토지"를 검색할 경우 :http://www.dlibrary.go.kr/openapi/call.do?dist_key=발급된키값&func_id=3&sw=%ED%86%A0%EC%A7%80
※ URL(한글)은 반드시 인코딩해야 함
※ 상세검색은 sw 값이 없을 경우 전체를 대상으로 검색합니다.
상세검색 샘플 URL
- 제목:"토지" 를 검색할 경우 : http://www.dlibrary.go.kr/openapi/call.do?dist_key=발급된키값&func_id=3&sw=%ED%86%A0%EC%A7%80&sf=title
출력결과 필드 (response field)
| No | 필드 | 값 | 설명 |
|---|---|---|---|
| 1 | total | - | 검색건수 |
| 2 | pg | - | 현재페이지 |
| 3 | code | - | 결과코드 |
| 4 | msg | - | 결과메시지 |
| 5 | cntPerPage | - | 쪽당출력건수 (기본 10건) |
| 7 | title | - | 제목 |
| 8 | author | - | 저자 |
| 9 | publisher | - | 발행처 |
| 10 | data_type | - | 자료 유형 |
| 11 | abstract1 | - | 국문초록 |
| 12 | abstract2 | - | 국문외 초록 |
| 13 | index | - | 목차 |
| 14 | file_url | - | 원문URL |
| 15 | ndl_bib_no | - | 국가전자도서관 서지번호 |
| 16 | publisher_year | - | 발행연도 |
※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다.
에러 메시지
| 에러코드 | 설명 |
|---|---|
| no_key_info | 인증키가 없습니다. |
| error | 내부에러가 발생했습니다. 시스템 관리자에 연락해주세요. |
| no_info | 정보가 없습니다. |
