ÀÎÅÍÆÄÅ©µµ¼¿¡ Á¦°øÇÏ´Â ½Å°£µµ¼ Open API ÀÔ´Ï´Ù. ÀÎÅÍÆÄÅ© µµ¼¿¡ µî·ÏµÇ´Â »óÇ°À» °¢ ºÐ¾ß·Î Áý°èÇÏ¿© Á¦°øµË´Ï´Ù.
1. ¿äû URL (request url)
http://book.interpark.com/api/recommend.api
2-1. ¿äû º¯¼ö (request parameter)
¿äû º¯¼ö | °ª | ¼³¸í |
---|---|---|
key | string (Çʼö) | ÀÌ¿ë µî·ÏÀ» ÅëÇØ ¹ÞÀº ÀÎÁõÅ°¸¦ ÀÔ·ÂÇÕ´Ï´Ù. |
categoryId | ºÐ¾ßÀÇ °íÀ¯ ¹øÈ£(Çʼö) |
ÁöÁ¤ÇÑ Ä«Å×°í¸®ÀÇ º£½ºÆ® ¼¿·¯¸¦ °Ë»öÇÕ´Ï´Ù. |
±¹³»µµ¼ ÀüüÀÇ ½Å°£µµ¼ º¸±â
http://book.interpark.com/api/recommend.api?key=interpark&categoryId=100
2-2. »ó¼¼ °Ë»ö-¿äû º¯¼ö (request parameter)
¡Ø »ó¼¼ °Ë»öÀº °Ë»ö Çʼö »çÇ×À» º¸ÀÚ ¼¼ºÎÀûÀ¸·Î ¼³Á¤ÇÏ¿© °Ë»öÇÒ ¼ö ÀÖµµ·Ï ÇÕ´Ï´Ù.
¿äû º¯¼ö | º¯¼ö ¿É¼Ç | ¼³¸í |
---|---|---|
output | xml(±âº»°ª) : REST XMLÇü½Ä json : JSON¹æ½Ä |
°Ë»ö °á°úÀÇ Ãâ·Â ¹æ½ÄÀ» ¼³Á¤ÇÕ´Ï´Ù. |
callback | javascript functionÀ̸§ | È£ÃâÈÄ ºÒ·ÁÁú javascript functionÀÇ À̸§À» ÁöÁ¤ÇÕ´Ï´Ù. * outputÀÌ jsonÀÎ °æ¿ì¿¡ ÇÑÇØ ÀÛµ¿µË´Ï´Ù. |
°á°ú°ªÀ» XML·Î Ãâ·ÂÇϱâ
http://book.interpark.com/api/recommend.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 | Á¤º¸°¡ Á¸ÀçÇÏÁö ¾Ê½À´Ï´Ù. |