개요

안내 페이지가 12월중 개편될 예정입니다. 서비스에 중단은 없으며 보다 편리하게 이용하실 수 있도록 노력중에 있습니다.

라이트노벨 API는 기존 여러 도서DB와 달리 라이트노벨에 특화한 데이터를 바탕으로 API형식으로 제공하는 서비스입니다.

해당 서비스에 등록된 데이터는 각 출판사 홈페이지, 서지정보유통지원시스템, 국립중앙도서관 순으로 반영합니다.

2015.12.17. 현재 시드노벨, 노블엔진 및 노블엔진 팝 발매작 등 총 1,156권이 정리되어 있으며, 다음과 같은 정보를 제공하고 있습니다.

  • ISBN (13자리)
  • 도서명
  • 부제목 (데이터 작업중)
  • 저자
  • 일러스트레이터
  • 역자
  • 레이블
  • 출판사
  • 이미지
  • 썸네일
  • 가격

아래 정보에 대해서는 제공하고 있지 않으며, 추후 제공될지에 대한 여부는 확실치 않습니다.

  • 한정판, 특별판, 예약여부 등
  • 출간일
  • 그 외 위 제공 항목에 없는 것

라이트노벨이 정식 발매되기 이전에는 일부 데이터가 부정확 또는 미기입된 경우가 있습니다. 확인되는 즉시 정확한 데이터로 교체되므로 양해 부탁드립니다.

사용방법

API는 URL로 쿼리를 전달하고, XML 및 json으로 결과값을 반환합니다.

월별 발매작 리스트

http://lnovel.kr/list.icz?year=[YEAR]&month=[MONTH]&label=[LABEL]&type=[type]

[YEAR]: 조회 할 연도입니다. 반드시 4자리로 이루어져야 하며, 기본값은 현재 연도입니다. (ex. 2015)
[MONTH]: 조회 할 월 입니다. 1자리 또는 2자리로 이루어져야 하며, 기본값은 현재 달 입니다. (ex. 1(O), 2(O), 12(O), 03(X))
[LABEL]: 레이블 별로 조회를 할 때 사용됩니다. L노벨(l), 시드노벨(sd), NT노벨(nt), 노블엔진(ne), 노블엔진 팝(np), 제이노블(j), AK노벨(ak), S노벨(s)입니다. 미입력시 전체 레이블이 조회됩니다.
[TYPE]: xml과 json을 선택할 수 있습니다. json은 minimize되어 제공됩니다. (기본값: xml) 2016년 1월 1일부터 json만 제공합니다.

도서 상세 정보

http://lnovel.kr/detail.icz?query=[QUERY]

[QUERY]: 도서를 검색할 쿼리입니다. 현재는 isbn으로의 검색만 가능합니다.

반환예제

http://lnovel.kr/list.icz?year=2015&month=2&label=sd&type=json 와 같이 요구한 경우

{"result":{"book":[{"title":"나와 호랑이님 12","author":"카넬","illust":"영인","label":"시드노벨","img":"http://resource.inculz.com/lnovel/seed/9788926798577.jpg","isbn":"9788926798577"},{"title":"쓰고 보니 노예계약, 나는 비정규직 히어로다 1","author":"이효원","illust":"ZIS","label":"시드노벨","img":"http://resource.inculz.com/lnovel/seed/9788926798607.jpg","isbn":"9788926798607"},{"title":"운디네 스트라이크 1","author":"최지인","illust":"REUM","label":"시드노벨","img":"http://resource.inculz.com/lnovel/seed/9788926798614.jpg","isbn":"9788926798614"}]}}

http://lnovel.kr/detail.icz?query=9788926799024 와 같이 요구한 경우

<result>
    <book>
        <title>협박연애 1</title>
        <author>NZ</author>
        <illust>gio</illust>
        <translator/>
        <label>시드노벨</label>
        <publisher>디앤씨미디어</publisher>
        <year>2015</year>
        <month>4</month>
        <price>7000</price>
        <isbn>9788926799024</isbn>
    </book>
</result>

오류코드 명세

001: DB 서버 오류입니다. 잠시 후 다시 시도해주세요.
011: 파라미터가 잘못되었습니다.

업데이트 내역

2015.02.15. DB 재작업 (시드노벨, 노블엔진), url 변경(api.lnovel.kr -> lnovel.kr)
2015.04.14. json 지원, 최적화 작업
2015.04.19. 파라미터 이름이 변경되었습니다. (y -> year, m -> month 등), 도서 상세정보 api 제공 시작(detail.icz)
2015.04.22. 이미지 서비스 시드노벨 시범 시작
2015.05.16. 이미지 서비스 정식 시작 (등록된 모든 발매작)
2015.05.17. 노블엔진 팝(발매작 전체), 익스트림노벨/NT노벨(5월작부터 순차 등록) 서비스 시작
2015.07.07. L노벨 서비스 시작(6월작부터 순차 등록), 썸네일(약 200x300, 가로 200px 고정, 세로 유동적이나 300px 내외) 제공 시작