더 나은 API 제공을 위해 기존 책 검색 API가 종료되고 새롭게 변경됩니다.
기존에 서비스 중이던 책 검색 API /v2/search/book 은 12월 31일에 종료되고, 새로운 책 검색 API /v3/search/book 으로 대체됩니다.
기존 책 검색 API를 사용하셨던 분들은 11월 1일 오픈된 신규 API로 전환해 주시길 바랍니다.
불편을 드린 점 양해 부탁드립니다.
API 변경사항은 아래와 같습니다.
- 책 검색 개편으로 지원하지 않는 요청 파라미터 및 응답 필드가 제거 되었습니다.
- 정렬 (sort) 파라미터 : sales
- 검색 필드 제한 (target)파라미터 : all, keyword, contents, overview
- 카테고리 파라미터 : category
- 검색 결과 응답 필드 : sale_yn, category, barcode, ebook_barcode
- ‘검색 필드 제한 (target)’ 요청 파라미터에 ‘인명에서 검색(person)’ 옵션이 추가되었습니다.
- 사용자가 비교적 쉽게 전환할 수 있도록 기존에 제공하던 응답 필드는 동일한 데이터 포맷으로 제공합니다.
왜 변경되었나요?
- 카테고리 체계는 도서정보 플랫폼 간 1:1 매핑이 불가능합니다. 이와 같이 가변성 있는 데이터는 정합성 유지, 일관된 정보 제공이 어려웠습니다. 정확한 정보 제공을 위해 일부 부정확한 파라미터가 제거되었습니다.
- 바코드는 교보문고 내에서 사용하는 전용 상품 코드였습니다. 이와 같이 범용성이 없고 불필요한 데이터를 제거하였습니다.