OpenAPI 안내

(최종 수정일 : 2022.7.13)
  • OpenAPI는 크게 3가지로 나눠집니다.
    (1) 검색API
    (2) 상품API (하나의 상품을 열람하는 API)
    (3) 상품 리스트 API (베스트셀러 등 각종 상품 리스트 API)
  • 상품API는 하나의 상품만을 열람하므로 검색API의 결과보다 자세한 부가 정보가 더해진 결과가 나옵니다.
  • 검색API/상품API/리스트API의 결과는 모두 XML형식(기본값), json형식 형식으로 받으실 수 있습니다.
  • 요청방식은 GET방식과 POST방식에 상관없이 요청 가능합니다.
  • OpenAPI는 1일 5,000회로 제한됩니다. 5,000회 이상을 원하시는 분은 OpenAPI 이용 안내를 참고해주세요.
  • 이전버젼(20070901)의 문서는 여기를 참고해주세요.
  • OpenAPI 이용 매뉴얼☞


상품 리스트 API

제공 리스트 종류
  • 신간 전체 리스트
  • 주목한 만한 신간 리스트
  • 편집자 추천 리스트(카테고리로만 조회 가능 - 국내도서/음반/외서 만 지원)
  • 베스트셀러
  • 북플 베스트셀러(국내도서 만 조회 가능)
요청 방법



API 키 발급 및 URL 등록하기☞



댓글(0) 먼댓글(0) 좋아요(4)
좋아요
북마크하기찜하기

1. OpenAPI 이용 조건


1) 개인이 비영리적인 목적으로 사용하는 경우 별도 조건 없이 사용 가능합니다.

2) 공공도서관 및 공공기관의 경우 아래 조건을 충족하는 경우 이용하실 수 있습니다.

    (1) 정보제공이 알라딘에서 되고 있다는 사실을 이용자들이 인지할 수 있도록 명시

    (2) 해당 상품이 알라딘 소개페이지로 연결 되어 이용자들이 알라딘에서 구매가 가능해야 함

    위 2가지 조건을 충족한다면 알라딘에 가입하신 이메일, OpenAPI Key, 위 조건 충족을 확인 할 수 있는

    화면캡쳐 또는 사이트 주소나 앱 이름을 openapi@aladin.co.kr로 보내주시기 바랍니다.

3) 도서 판매, 도서 정보를 기반으로 하는 법인/기업/단체 서비스, 영리 목적의 서비스인 경우 이용이 불가능합니다.



2. OPEN API 이용 절차 (OpenAPI Key 발급)


1) 알라딘 회원 가입 후 OpenAPI를 사용할 URL정보를 등록해주세요.

   ▶ API 키 발급 및 URL 등록하기


2) URL 정보 등록이 완료되면 OpenAPI 인증키가 발급되며 즉시 사용이 가능합니다.


3) 하루 쿼리 호출수는 5천건으로 제한됩니다.



3. 프리미엄 OPEN API 이용


OpenAPI의 하루 쿼리 호출수는 5천회로 제한 되어 있으며, 상품의 목차나 소개 등 일부 정보들은 제공되지 않습니다.

프리미엄 OpenAPI 이용시 하루 10만회(1시간당 최대 1만회) 호출이 가능하며 목차나 소개 등의 정보도 모두 제공하고 있습니다.

프리미엄 OpenAPI는 아래 조건을 모두 충족하는 경우 심사에 따라 제공하고 있으며 심사 결과에 관해서는 승인 여부만 안내 드리고 있는 점 참고 바랍니다.


알라딘 OpenAPI(기본형)를 이용 중인 상태에서만 프리미엄을 신청할 수 있습니다. 기본형으로 이용하면서, 호출량 증대 및 추가적인 DB스펙이 필요한 경우에 프리미엄을 신청할 수 있습니다. 기존에 기본형을 이용하지 않고, 바로 프리미엄을 신청하는 경우, 이용 목적 및 이용 실체를 파악할 수 없어서 프리미엄 검토가 불가능하니, 일단은 기본형으로 서비스를 이용하여 개발한 이후에 프리미엄을 신청해주세요.


1) 알라딘 OpenAPI(기본형)를 이용하고 있어야 합니다(단, 서비스 성격상 프리미엄으로만 제공받을 수 있는 콘텐츠로 인해, 반드시 프리미엄 자격을 획득한 이후에 개발할 수 있는 경우에는 이용 실체를 파악할 수 있는 설명/자료를 자세히 해주세요).

2) 해당 앱/프로그램 등에서 정보의 출처가 알라딘임을 명시하여야 합니다.

   - 출처 문구 : 도서 DB 제공 : 알라딘 인터넷서점(www.aladin.co.kr)

3) 상품 정보 페이지 내에 알라딘으로 연결되는 버튼이 노출되어야 합니다.

   - ‘자세히보기’ 또는 ‘구매하기’ 버튼이 알라딘 상품 페이지로 연결 되어야 함

4) 상품 정보 링크시 타 인터넷서점으로의 연결 제공 없이 알라딘만 단독으로 연결되어야 합니다.

5) 위 조건에 대한 이행 여부 점검시 증빙자료 제출이 필요합니다.

   - 연 1회의 정기 점검이 있으며, 그 외 회사의 필요에 따라 제출 요청이 있을 수 있습니다.


신청방법

아래 링크를 클릭해서 자료 제출을 해주세요.


  ▶ 프리미엄 이용 신청 및 자료제출 


※ 공공도서관 및 공공기관에서 프로그램을 납품 받아 사용하는 경우

1) 사용하는 기관별로 OpenAPI 인증키를 발급 받으셔야 합니다.

2) 기관에서 직접 알라딘 회원 가입 이후 인증키를 발급 받으셔야 합니다.

3) 프리미엄 API가 필요할시 기관에서 위 링크를 통해 자료를 제출해 주셔야 합니다.







댓글(0) 먼댓글(0) 좋아요(15)
좋아요
북마크하기찜하기

예제 파일


  • 아래 파일은 aladdin OpenAPI를 이용한 간단한 프로그램들입니다.

  • C#의 경우는 Full Library를 제공하고, 기타 언어는 간단한 예제를 포함하고 있습니다.

  • 개선사항이나 기타 문제점 발견시 openapi@aladin.co.kr로 연락바랍니다.

개발언어 다운로드 링크 테스트환경
C# [Down] Microsoft.Net Framework 2.0/mono 1.2.5
php [Down] PHP 5.2.4RC1 + Apache 2.2.5.0
java [Down] java 1.6.0
python [Down] python 2.5
ruby [Down] ruby 1.8.6
Power Shell [Down] Power Shell 1.0

 



댓글(0) 먼댓글(0) 좋아요(3)
좋아요
북마크하기찜하기