[JAVA_OpenAPI] Kakao 책검색 Api _ REST API

책검색 API

HOST : https://dapi.kakao.com

URL : /v3/search/book 

METHOD : GET

* URL은 v2은 18.12.31 기준으로 종료되며 /v3/search/book 으로 바뀝니다.

• 책 검색 개편으로 지원하지 않는 요청 파라미터 및 응답 필드가 제거 되었습니다.

• 정렬(sort) 파라미터 : sale
• 검색 필드 제한(target) 파라미터 : all, keyword, contents, overview
• 카테고리 파라미터 : category
• 검색 결과 응답 필드 : sale_yn, category, barcode, ebook_barcode

• '검색 필드 제한 (target)' 요청 파라미터에 '인명에서 검색(person)' 옵션이 추가되었습니다.
• 사용자가 비교적 쉽게 전환할 수 있도록 기존에 제공하던 응답 필드는 동일한 데이터 포멧으로 제공합니다.

책검색 API TEST ( REST API Test)

https://developers.kakao.com/docs/restapi/tool#search-api#/v2/search/book

책검색 API 레퍼런스

https://developers.kakao.com/docs/restapi/search#책-검색

1. API KEY를 발급받기

https://developers.kakao.com/

위의 사이트에 카카오 로그인을 합니다. (카카오 계정이 없을 경우 API키를 받을 수 없습니다.)

로그인 후 메인 상단에 이름이 뜨며 그 옆에있는 ▼ 를 누르면 내 애플리케이션이 나옵니다. 

이곳에서 앱만들기(프로젝트)를 눌러 앱을 하나 만듭니다.

그리고 대충 프로젝트를 설정하고 들어가면 메인 가운데에서 '앱 키 표시' 라는 링크를 클릭하면

아래와 같이 여러 키들이 나오며 그중에 REST 키를 받아 옵니다.

 

REST API 개발 가이드에 따르면

GET방식으로 앱키(REST API 키)는 헤더에 담아 요청한다고 되어있습니다.

검색어는 파라미터 값으로 추가 하며 'query'는 검색어가 되는 파라미터로 필수 입니다.

[Request]

Params	기능	설명
query	검색 질의어	필수
sort	결과 문서 정렬 방식	기본값 : accuracy(정확도 순)  - accuracy, recency(최신순)
page	결과 페이지 번호	기본값 : 1  - 최소값 1, 최대값 50
size	한 페이지에 출력될 결과 수	기본값 : 10  - 최소값 1, 최대값 50
target	검색 필드 제한	기본값 : all( 전체에서 검색)  - title (제목에서 검색) or isbn (ISBN에서 검색) or publisher (출판사에서 검색) or person(인명에서 검색)
category	카테고리 필터링	사이트 참조..(너무 많아요..)

[Response]

- meta

Key	설명	타입
total_count	전체 검색된 문서수	Integer
pageable_count	검색결과로 제공가능한 문서수	Integer
is_end	현재 페이지가 마지막페이지인지 여부 값이 false이면 page를 증가시켜 다음페이지를 요청할 수 있음	Boolean

- document

Key	설명	타입
title	도서 제목	String
contents	도서소개	String
url	도서 상세 URL	String
isbn	국제 표준 도서번호(ISBN10 ISBN13) (ISBN10, ISBN13 중 하나 이상 존재, ' '(공백)을 구분자로 출력)	String
datetime	도서출판 날짜. ISO 8601 [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz]	String
authors	도서 저자 리스트	Array of String
publisher	도서 출판사	String
translators	도서 번역자 리스트	Array of String
price	도서 정가	Interger
sale_price	도서 판매가	Interger
thumbnail	도서 표지 썸네일 URL	String
status	도서 판매상태 정보 (정상, 품절, 절판등) - 상황에 따라 변동이 있으므로 문자열 처리 지양, 단순 노출요소로 활용을 권장	String

간편 참조 ( URL, HOST, 기능, 에러 메시지등)

https://developers.kakao.com/docs/restapi/quick-reference#rest-api

추후 수정