º£½ºÆ®¼¿·¯

ÀÎÅÍÆÄÅ©µµ¼­¿¡ Á¦°øÇÏ´Â º£½ºÆ® ¼¿·¯ Open API ÀÔ´Ï´Ù. ÀÎÅÍÆÄÅ© µµ¼­¿¡¼­ °¢ ºÐ¾ßº° ÆǸŷ®À» ±âÁØÀ¸·Î Áý°èÇÏ¿© Á¦°øµË´Ï´Ù.

 

1. ¿äû URL (request url)

http://book.interpark.com/api/bestSeller.api

2-1. ¿äû º¯¼ö (request parameter)

¿äû º¯¼ö °ª ¼³¸í
key string (Çʼö) ÀÌ¿ë µî·ÏÀ» ÅëÇØ ¹ÞÀº ÀÎÁõÅ°¸¦ ÀÔ·ÂÇÕ´Ï´Ù.
categoryId

ºÐ¾ßÀÇ °íÀ¯ ¹øÈ£(Çʼö)

Ä«Å×°í¸® ´Ù¿î·Îµå

ÁöÁ¤ÇÑ Ä«Å×°í¸®ÀÇ º£½ºÆ® ¼¿·¯¸¦ °Ë»öÇÕ´Ï´Ù.

»ùÇÃ URL

±¹³»µµ¼­ ÀüüÀÇ º£½ºÆ® ¼¿·¯ º¸±â

http://book.interpark.com/api/bestSeller.api?key=interpark&categoryId=100

2-2. »ó¼¼ °Ë»ö-¿äû º¯¼ö (request parameter)

¡Ø »ó¼¼ °Ë»öÀº °Ë»ö Çʼö »çÇ×À» º¸ÀÚ ¼¼ºÎÀûÀ¸·Î ¼³Á¤ÇÏ¿© °Ë»öÇÒ ¼ö ÀÖµµ·Ï ÇÕ´Ï´Ù.

¿äû º¯¼ö º¯¼ö ¿É¼Ç ¼³¸í
output xml(±âº»°ª) : REST XMLÇü½Ä
json : JSON¹æ½Ä
°Ë»ö °á°úÀÇ Ãâ·Â ¹æ½ÄÀ» ¼³Á¤ÇÕ´Ï´Ù.
callback javascript functionÀ̸§ È£ÃâÈÄ ºÒ·ÁÁú javascript functionÀÇ À̸§À» ÁöÁ¤ÇÕ´Ï´Ù.
* outputÀÌ jsonÀÎ °æ¿ì¿¡ ÇÑÇØ ÀÛµ¿µË´Ï´Ù.

»ùÇÃ URL

°á°ú°ªÀ» XML·Î Ãâ·ÂÇϱâ
http://book.interpark.com/api/bestSeller.api?key=interpark&categoryId=100&output=xml

 

3. Ãâ·Â °á°ú Çʵå (response field)

¿äû º¯¼ö °ª ¼³¸í
title ¹®ÀÚ¿­ °Ë»ö °á°ú ÆäÀÌÁöÀÇ Á¦¸ñÀ» Ç¥½ÃÇÔ´Ï´Ù.
link ¹®ÀÚ¿­(URL) °Ë»ö °á°ú¸¦ È®ÀÎ ÇÒ ¼ö ÀÖ´Â ÆäÀÌÁö ÁÖ¼Ò(URL)À» Ç¥½ÃÇÕ´Ï´Ù.
imageUrl ¹®ÀÚ¿­(URL) Á¦°øÀÚÀÇ À̹ÌÁö ÁÖ¼Ò(URL)À» Ç¥½ÃÇÕ´Ï´Ù.
language ¹®ÀÚ¿­ °â»ö °á°úÀÇ ¾ð¾î¸¦ Ç¥½ÃÇÕ´Ï´Ù.
copyright ¹®ÀÚ¿­ API Á¦°øÀÚÀÇ Copyright¸¦ Ç¥½ÃÇÕ´Ï´Ù.
pubDate ³¯Â¥ °Ë»ö °á°ú¸¦ »ý¼ºÇÑ ½Ã°£À» Ç¥½ÃÇÕ´Ï´Ù.. (GMT ±âÁؽÃ)
totalResults ¼ýÀÚ ÃÑ °Ë»ö °á°úÀÇ °³ ¼ö¸¦ Ç¥½ÃÇÕ´Ï´Ù.
startIndex

¼ýÀÚ

ÇöÀçÀÇ ÆäÀÌÁö ¹øÈ£¸¦ Ç¥½ÃÇÕ´Ï´Ù.
itemsPerPage ¼ýÀÚ ÇÑ ÆäÀÌÁö´ç Ç¥½ÃµÇ´Â °Ë»ö °á°ú °³¼ö¸¦ Ç¥½ÃÇÕ´Ï´Ù.
maxResults ¼ýÀÚ °Ë»öÀ» ¿äûÇÑ ÆäÀÌÁö´ç °á°ú °³¼ö¸¦ Ç¥½ÃÇÕ´Ï´Ù.
query ¹®ÀÚ¿­ °Ë»öÀ» ¿äûÇÑ Äõ¸®(°Ë»ö¾î)¸¦ Ç¥½ÃÇÕ´Ï´Ù.
searchCategoryId ¼ýÀÚ °Ë»ö °á°ú¸¦ ¿äûÇÑ Ä«Å×°í¸®ÀÇ ¾ÆÀ̵ð°ªÀ» Ç¥½ÃÇÕ´Ï´Ù.
searchCategoryName ¹®ÀÚ¿­ °Ë»ö °á°ú¸¦ ¿äûÇÑ Ä«Å×°í¸®ÀÇ À̸§À» Ç¥½ÃÇÕ´Ï´Ù.
returnCode ¼ýÀÚ ¿À·ù¸Þ½ÃÁöÀÇ Äڵ带 Ç¥½ÃÇÕ´Ï´Ù.
returnMessage ¹®ÀÚ¿­ ¿À·ù¸Þ½ÃÁö¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < itemId ¼ýÀÚ °Ë»ö »óÇ°ÀÇ °íÀ¯¹øÈ£¸¦ Ç¥½ÃÇÕ´Ï´Ù.(»óÇ°¹øÈ£)
item < title ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ À̸§À» Ç¥½ÃÇÔ´Ï´Ù.
item < isbn ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ ISBNÀ» Ç¥½ÃÇÕ´Ï´Ù.
item < url ¹®ÀÚ¿­(URL) °Ë»ö »óÇ°ÀÇ ÁÖ¼Ò(URL)À» Ç¥½ÃÇÕ´Ï´Ù.
¡Ø '°í¸¿½À´Ï´Ù' Àû¸³ : ÁÖ¼Ò¿¡ "&key=ÀÎÁõÅ°"¸¦ Ãß°¡ÇÏ¿©¾ß ÇÕ´Ï´Ù.
item < author ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ ÀúÀÚ(À½¾ÇÀÏ °æ¿ì °¡¼ö, DVDÀÏ °æ¿ì °¨µ¶)¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < translator ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ ¿ªÀÚ(DVDÀÏ °æ¿ì ¹è¿ì)¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < description ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ ¼³¸íÀ» Ç¥½ÃÇÕ´Ï´Ù. (HTML Á¦¿Ü)
item < priceStandard ¼ýÀÚ(ÅëÈ­) °Ë»ö »óÇ°ÀÇ Á¤°¡¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < priceSales ¼ýÀÚ(ÅëÈ­) °Ë»ý »óÇ°ÀÇ ÆǸŰ¡¸¦ Ç¥½ÃÇÕ´Ï´Ù. (¼ö½Ã·Î º¯µ¿ µÉ ¼ö ÀÖ½À´Ï´Ù.)
item < discountRate ¼ýÀÚ °Ë»ö »óÇ°ÀÇ ÇÒÀÎÀ²À» Ç¥½ÃÇÕ´Ï´Ù. (´ÜÀ§ %)
item < saleStatus ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ ÆǸŠ»óŸ¦ Ç¥½ÃÇÕ´Ï´Ù.
item < mileage ¼ýÀÚ(ÅëÈ­) °Ë»ö »óÇ°ÀÇ »óÇ° ±¸¸Å½Ã Áö±ÞµÇ´Â ¸¶Àϸ®Áö¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < mileageRate ¼ýÀÚ °Ë»ö »óÇ°ÀÇ »óÇ° ±¸¸Å½Ã Áö±ÞµÇ´Â ¸¶Àϸ®ÁöÀ²À» Ç¥½ÃÇÕ´Ï´Ù.(´ÜÀ§ %)
item < coverSmallUrl ¹®ÀÚ¿­(URL) °Ë»ö »óÇ°ÀÇ ÀÛÀº »çÀÌÁî À̹ÌÁö¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < coverLargeUrl ¹®ÀÚ¿­(URL) °Ë»ö »óÇ°ÀÇ Å« »çÀÌÁî ¾Æ¹ÌÁö¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < categoryId ¼ýÀÚ °Ë»ö »óÇ°ÀÌ ¼ÓÇÑ Ä«Å×°í¸®ÀÇ ¾ÆÀ̵ð°ªÀ» Ç¥½ÃÇÕ´Ï´Ù.
item < categoryName ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÌ ¼ÓÇÑ Ä«Å×°í¸®ÀÇ À̸§À» Ç¥½ÃÇÕ´Ï´Ù.
item < publisher ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ ÃâÆÇ»ç(Á¦ÀÛ»ç)¸¦ Ç¥½ÃÇÕ´Ï´Ù.
item < pubDate ¹®ÀÚ¿­ °Ë»ö »óÇ°ÀÇ Ãâ°£ÀÏ(µî·ÏÀÏ)À» Ç¥½ÃÇÕ´Ï´Ù.

4. ºñ°í/¿¡·¯ ¸Þ½ÃÁö

¿¡·¯ÄÚµå ¿¡·¯ ¸Þ½ÃÁö
000 Á¤»ó
001 ½Ã½ºÅÛ ¿¡·¯
101 µî·ÏµÇÁö ¾ÊÀº Å°ÀÔ´Ï´Ù.
102 »ç¿ëÇÒ ¼ö ¾ø´Â Å°ÀÔ´Ï´Ù.
OpenAPI¿¡ µî·ÏµÇ¾úÀ¸³ª, ÀϽÃÀûÀ¸·Î »ç¿ë ÁßÁöµÈ Å°¸¦ ÅëÇÏ¿© Äõ¸®¸¦ °Ë»öÇÏ´Â °æ¿ì ¹ß»ýÇÏ´Â ¿¡·¯ÀÔ´Ï´Ù.
201 authKey ÆĶó¹ÌÅÍ°¡ ¾ø½À´Ï´Ù.
202 query ÆĶó¹ÌÅÍ°¡ ¾ø½À´Ï´Ù.
203 categoryId ÆĶó¹ÌÅÍ°¡ ¾ø½À´Ï´Ù.
301 ºÎÀûÀýÇÑ queryType°ªÀÔ´Ï´Ù.
302 ºÎÀûÀýÇÑ searchTarget °ªÀÔ´Ï´Ù.
303 ºÎÀûÀýÇÑ start °ªÀÔ´Ï´Ù.
304 ºÎÀûÀýÇÑ maxResults °ªÀÔ´Ï´Ù.
305 ºÎÀûÀýÇÑ adultImageExposure °ªÀÔ´Ï´Ù.
306 ºÎÀûÀýÇÑ query °ªÀÔ´Ï´Ù. queryTypeÀÌ productNumberÀÏ °æ¿ì ¼ýÀÚ·Î ¼³Á¤ÇØ¾ß ÇÕ´Ï´Ù.
307 Á¤ÀǵÇÁö ¾ÊÀº sort°ªÀÔ´Ï´Ù.
308 Á¤ÀǵÇÁö ¾ÊÀº categoryId °ªÀÔ´Ï´Ù.
309 Á¤ÀǵÇÁö ¾ÊÀº output °ªÀÔ´Ï´Ù.
310 Á¤ÀǵÇÁö ¾ÊÀº inputEncoding °ªÀÔ´Ï´Ù.
311 Á¤ÀǵÇÁö ¾ÊÀº soldOut °ªÀÔ´Ï´Ù.
400 1ÀÏÁ¢¼ÓÁ¦ÇÑÀ» ÃÊ°úÇÏ¿´½À´Ï´Ù.
401 Á¤º¸°¡ Á¸ÀçÇÏÁö ¾Ê½À´Ï´Ù.