• 透过案例看清API接口的作用——演示1688商品详情接口


     注册获取专属于你的key和secret

     

    一、首先要了解api接口是什么

    1.API是什么?

    API应用程序接口(API:application programming interface),是一组定义、程序及协议的集合,通过API接口实现计算机软件之间的相互通信。API的一个主要功能是提供通用功能集。程序员通过使用API函数开发应用程序,从未避免编写无用程序,以减轻编程任务。API同时也是一种中间件,为各种不同平台提供数据共享。

    通俗的说就是:API实际就是一种程序接口,就像你的电脑主机上有usb接口、低音炮接口、麦克风接口、显示器接口等等,一套程序也要有这么一个接口一边开发更多的功能。API接口的扩展性很强,程序员能够用它给原有程序增加很多功能。web2.0型网站大多会开放API,以便使懂得编程的网友开发出丰富的功能,从未达到完善服务的目的。

    2.API说明文档是什么?

    API说明文档是使用(iava API doc),其中包括所有接口和实体的说明使用。可以在浏览器下使用,方便用户的使用。使用时,打开docs目录下index.html文件即可。

    3.API分为四种类型

    (1)远程过程调用(RPC):通过作用在共享数据缓存器上的过程(或任务)实现程序间的通信。

    (2)标准查询语言(SQL)是标准的访问数据的查询语言,通过通用数据库实现应用程序间数据共享。

    (3)文件传输:文件传输通过发送格式化文件实现应用程序间数据共享。

    (4)信息交付:指松耦合或紧耦合应用程序间的小型格式化信息,通过程序间的直接通信实现数据共享。

    4、API提供方式

    这是一种实时获取数据的方式,也是时下最好的方式。这种方式的流程是:数据提供一组API(可以使Java、C++、webservice等方式),供数据接收方使用。数据接收方根据自己的需求,填写相应的参数,通过调用API可以直接从数据供应商那里获得及时、最新的数据。
     

     二、接口演示——1688商品详情接口

    前往注册开启免费测试

    为了进行此平台API的调用,首先我们需要做下面几件事情。

    1、 首先需要通过注册获取专属的key

    2、 参考API文档里的接入方式和示例。

    3、查看测试工具是否有需要的接口,响应实例的返回字段是否符合参数要求。

    4、利用平台的文档中心和API测试工具,对接口进行测试、程序获取

    请求参数

    请求参数:num_iid=652014604299

    参数说明:num_iid:1688商品ID
    sales_data:&sales_data=1 获取近30天成交数据
    agent:&agent=1 获取1688分销代发价格数据

    请求示例

    	
    -- 请求示例 url 默认请求参数已经URL编码处理
    curl -i "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360"
    1. Request address:
    2. https://api-gw.onebound.cn/1688/item_get/?key=注册获取&
    3. &num_iid=652014604299&&lang=zh-CN&secret=注册获取
    4. ---------------------------------------
    5. Result Object:
    6. ---------------------------------------
    7. {
    8. "item": {
    9. "num_iid": "652014604299",
    10. "title": "风衣外套女款小个子时尚东大门2022新款春秋垂感外套女装风衣批发",
    11. "desc_short": "",
    12. "price": "308.00",
    13. "total_price": 0,
    14. "suggestive_price": 0,
    15. "orginal_price": "318.00",
    16. "nick": "Lee show ming实力旗舰店",
    17. "num": "1774",
    18. "detail_url": "https://detail.1688.com/offer/652014604299.html",
    19. "pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01AZIpo120s5B49MgJn_!!2208347006904-0-cib.jpg",
    20. "brand": "",
    21. "brandId": "",
    22. "rootCatId": "10166",
    23. "cid": "319",
    24. "desc": "
      \"offer-template-0\">

      \"https://cbu01.alicdn.com/img/ibank/O1CN01caNBpT20s5CkdZXZH_!!2208347006904-0-cib.jpg?__r__=1657679771488\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01VkLgv920s5CtIoptg_!!2208347006904-0-cib.jpg?__r__=1657679771488\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01wVuvMO20s5CkdcDtS_!!2208347006904-0-cib.jpg?__r__=1657679771488\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01hr2Ley20s5Cs50ow6_!!2208347006904-0-cib.jpg?__r__=1657679771488\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01TBq9mG20s5Cn0RjFY_!!2208347006904-0-cib.jpg?__r__=1657679771488\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01RKhavh20s5CbAATJ4_!!2208347006904-0-cib.jpg?__r__=1657679771489\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN013WRPcF20s5CiKa6cB_!!2208347006904-0-cib.jpg?__r__=1657679771489\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01Rls8Sr20s5Cg2aV1o_!!2208347006904-0-cib.jpg?__r__=1657679771489\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01cgBF9y20s5Cn0QaYg_!!2208347006904-0-cib.jpg?__r__=1657679771489\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01kuT9aM20s5CrILSmZ_!!2208347006904-0-cib.jpg?__r__=1657679771489\" alt=\"undefined\"/>

      \r\n

      \"https://cbu01.alicdn.com/img/ibank/O1CN01PEFGBF20s5Cs52UwI_!!2208347006904-0-cib.jpg?__r__=1657679791807\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01nvdG0z20s5CbAC9K0_!!2208347006904-0-cib.jpg?__r__=1657679791807\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01CdCMqj20s5CkdctYf_!!2208347006904-0-cib.jpg?__r__=1657679791807\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01GG52MQ20s5CkkadkW_!!2208347006904-0-cib.jpg?__r__=1657679791807\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN013a5iRA20s5ChZphwR_!!2208347006904-0-cib.jpg?__r__=1657679791808\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN015MOP2R20s5CtIrvIg_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01JBibtW20s5Cg2dWJm_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01wUoodX20s5CrIPgvo_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01bTYClX20s5CiKc3LA_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01BVHp9s20s5ClS6yYK_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01zm97EY20s5Cn0SwH2_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01XDMqpz20s5CrIP5W1_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN01uZiVcz20s5CpFwWQy_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>\"https://cbu01.alicdn.com/img/ibank/O1CN013vnl8620s5ChZqNb4_!!2208347006904-0-cib.jpg?__r__=1657679818216\" alt=\"undefined\"/>

      \"
      https://www.o0b.cn/i.php?t.png&rid=gw-1.62e8c51595335&p=1778787198&k=i_key&t=1659421974\" style=\"display:none\" />",
    25. "item_imgs": [
    26. {
    27. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01AZIpo120s5B49MgJn_!!2208347006904-0-cib.jpg"
    28. },
    29. {
    30. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01iA3tQQ20s5ApqTh4w_!!2208347006904-0-cib.jpg"
    31. },
    32. {
    33. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01dJdIkt20s5B0oII27_!!2208347006904-0-cib.jpg"
    34. },
    35. {
    36. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01e69Ct120s5AzrOVor_!!2208347006904-0-cib.jpg"
    37. },
    38. {
    39. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01YUp5XX1Bs2lHTcJ8y_!!0-0-cib.jpg"
    40. },
    41. {
    42. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01pA6liv20s58ZUKjeD_!!2208347006904-0-cib.jpg"
    43. },
    44. {
    45. "url": "https://cbu01.alicdn.com/img/ibank/O1CN019MPZGs20s595GwIla_!!2208347006904-0-cib.jpg"
    46. },
    47. {
    48. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01PaqyeD20s591X4GRt_!!2208347006904-0-cib.jpg"
    49. },
    50. {
    51. "url": "https://cbu01.alicdn.com/img/ibank/O1CN019eICov20s58TyCzpB_!!2208347006904-0-cib.jpg"
    52. }
    53. ],
    54. "item_weight": "",
    55. "post_fee": 10,
    56. "express_fee": "",
    57. "ems_fee": "",
    58. "shipping_to": "",
    59. "video": null,
    60. "sample_id": "",
    61. "props_name": "0:0:黑色;0:1:米色;0:2:深米色;0:3:浅米色;1:0:均码",
    62. "prop_imgs": {
    63. "prop_img": [
    64. {
    65. "properties": "0:0",
    66. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01pA6liv20s58ZUKjeD_!!2208347006904-0-cib.jpg"
    67. },
    68. {
    69. "properties": "0:1",
    70. "url": "https://cbu01.alicdn.com/img/ibank/O1CN019eICov20s58TyCzpB_!!2208347006904-0-cib.jpg"
    71. },
    72. {
    73. "properties": "0:2",
    74. "url": "https://cbu01.alicdn.com/img/ibank/O1CN01PaqyeD20s591X4GRt_!!2208347006904-0-cib.jpg"
    75. },
    76. {
    77. "properties": "0:3",
    78. "url": "https://cbu01.alicdn.com/img/ibank/O1CN019MPZGs20s595GwIla_!!2208347006904-0-cib.jpg"
    79. }
    80. ]
    81. },
    82. "property_alias": "0:0:黑色;0:1:米色;0:2:深米色;0:3:浅米色;1:0:均码",
    83. "props": [
    84. {
    85. "name": "货号",
    86. "show": false,
    87. "value": "07808TC"
    88. },
    89. {
    90. "name": "品牌",
    91. "show": false,
    92. "value": "Lee show ming"
    93. },
    94. {
    95. "name": "面料名称",
    96. "show": false,
    97. "value": "棉"
    98. },
    99. {
    100. "name": "主面料成分",
    101. "show": false,
    102. "value": "棉"
    103. },
    104. {
    105. "name": "主面料成分2",
    106. "show": false,
    107. "value": "醋酯纤维"
    108. },
    109. {
    110. "name": "图案",
    111. "show": false,
    112. "value": "纯色"
    113. },
    114. {
    115. "name": "厚薄",
    116. "show": false,
    117. "value": "中等"
    118. },
    119. {
    120. "name": "版型",
    121. "show": false,
    122. "value": "直筒型"
    123. },
    124. {
    125. "name": "衣长",
    126. "show": false,
    127. "value": "中长款(65cm<衣长≤80cm)"
    128. },
    129. {
    130. "name": "领型",
    131. "show": false,
    132. "value": "翻领"
    133. },
    134. {
    135. "name": "袖长",
    136. "show": false,
    137. "value": "长袖"
    138. },
    139. {
    140. "name": "流行元素",
    141. "show": false,
    142. "value": "口袋"
    143. },
    144. {
    145. "name": "工艺",
    146. "show": false,
    147. "value": "免烫处理"
    148. },
    149. {
    150. "name": "上市年份/季节",
    151. "show": false,
    152. "value": "2022年秋季"
    153. },
    154. {
    155. "name": "颜色",
    156. "show": false,
    157. "value": "黑色,米色,深米色,浅米色"
    158. },
    159. {
    160. "name": "尺码",
    161. "show": false,
    162. "value": "均码"
    163. },
    164. {
    165. "name": "风格类型",
    166. "show": false,
    167. "value": "气质通勤"
    168. },
    169. {
    170. "name": "袖型",
    171. "show": false,
    172. "value": "常规袖"
    173. },
    174. {
    175. "name": "门襟",
    176. "show": false,
    177. "value": "双排扣"
    178. },
    179. {
    180. "name": "主面料成分含量",
    181. "show": false,
    182. "value": "50%(不含)-70%(含)"
    183. },
    184. {
    185. "name": "风格",
    186. "show": false,
    187. "value": "都市风,英伦风,优雅风,通勤风,知性风"
    188. },
    189. {
    190. "name": "是否跨境货源",
    191. "show": false,
    192. "value": "否"
    193. },
    194. {
    195. "name": "主面料成分2含量",
    196. "show": false,
    197. "value": "50%(不含)-70%(含)"
    198. }
    199. ],
    200. "total_sold": null,
    201. "scale": "",
    202. "sellUnit": "件",
    203. "skus": {
    204. "sku": [
    205. {
    206. "price": "318.00",
    207. "total_price": 0,
    208. "sales": "0",
    209. "properties": "0:0;1:0",
    210. "properties_name": "0:0:颜色:黑色;1:0:尺码:均码",
    211. "quantity": "519",
    212. "sku_id": "4879016278070",
    213. "spec_id": "7ccb9e57d1d5f349172254f5c3eb0f3e"
    214. },
    215. {
    216. "price": "318.00",
    217. "total_price": 0,
    218. "sales": "0",
    219. "properties": "0:1;1:0",
    220. "properties_name": "0:1:颜色:米色;1:0:尺码:均码",
    221. "quantity": "450",
    222. "sku_id": "4879016278071",
    223. "spec_id": "53865acdf0df3b493e458fedeb1185a7"
    224. },
    225. {
    226. "price": "318.00",
    227. "total_price": 0,
    228. "sales": "0",
    229. "properties": "0:2;1:0",
    230. "properties_name": "0:2:颜色:深米色;1:0:尺码:均码",
    231. "quantity": "365",
    232. "sku_id": "4908340799409",
    233. "spec_id": "93c307db4d7136f0c5d146ae8cb2f5ce"
    234. },
    235. {
    236. "price": "318.00",
    237. "total_price": 0,
    238. "sales": "0",
    239. "properties": "0:3;1:0",
    240. "properties_name": "0:3:颜色:浅米色;1:0:尺码:均码",
    241. "quantity": "440",
    242. "sku_id": "4908340799410",
    243. "spec_id": "22be0585d6eff09f8b45734aa18ba6e5"
    244. }
    245. ]
    246. },
    247. "seller_id": "2208347006904",
    248. "sales": 307,
    249. "shop_id": "2208347006904",
    250. "props_list": {
    251. "0:0": "颜色:黑色",
    252. "0:1": "颜色:米色",
    253. "0:2": "颜色:深米色",
    254. "0:3": "颜色:浅米色",
    255. "1:0": "尺码:均码"
    256. },
    257. "seller_info": {
    258. "nick": "Lee show ming实力旗舰店",
    259. "user_num_id": "2208347006904",
    260. "sid": "b2b-2208347006904ae848",
    261. "title": "Lee show ming实力旗舰店",
    262. "zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2208347006904ae848",
    263. "shop_name": "Lee show ming实力旗舰店"
    264. },
    265. "tmall": "",
    266. "data_from": "1688app",
    267. "error": "",
    268. "unit": null,
    269. "is_support_mix": "true",
    270. "mix_amount": "50",
    271. "mix_begin": "0",
    272. "mix_number": "2147483647",
    273. "min_num": "2",
    274. "props_img": {
    275. "0:0": "https://cbu01.alicdn.com/img/ibank/O1CN01pA6liv20s58ZUKjeD_!!2208347006904-0-cib.jpg",
    276. "0:1": "https://cbu01.alicdn.com/img/ibank/O1CN019eICov20s58TyCzpB_!!2208347006904-0-cib.jpg",
    277. "0:2": "https://cbu01.alicdn.com/img/ibank/O1CN01PaqyeD20s591X4GRt_!!2208347006904-0-cib.jpg",
    278. "0:3": "https://cbu01.alicdn.com/img/ibank/O1CN019MPZGs20s595GwIla_!!2208347006904-0-cib.jpg"
    279. },
    280. "location": "辽宁省 大连市",
    281. "priceRange": [
    282. [
    283. "2",
    284. "318.00"
    285. ],
    286. [
    287. "10",
    288. "308.00"
    289. ]
    290. ],
    291. "priceRangeOriginal": [],
    292. "sales_info": {
    293. "seller_num": "",
    294. "repeat_rate_purchase": "",
    295. "per_capita_purchases": "",
    296. "comment_num": "",
    297. "comment_url": ""
    298. },
    299. "format_check": "ok",
    300. "desc_img": [
    301. "https://cbu01.alicdn.com/img/ibank/O1CN01caNBpT20s5CkdZXZH_!!2208347006904-0-cib.jpg?__r__=1657679771488",
    302. "https://cbu01.alicdn.com/img/ibank/O1CN01VkLgv920s5CtIoptg_!!2208347006904-0-cib.jpg?__r__=1657679771488",
    303. "https://cbu01.alicdn.com/img/ibank/O1CN01wVuvMO20s5CkdcDtS_!!2208347006904-0-cib.jpg?__r__=1657679771488",
    304. "https://cbu01.alicdn.com/img/ibank/O1CN01hr2Ley20s5Cs50ow6_!!2208347006904-0-cib.jpg?__r__=1657679771488",
    305. "https://cbu01.alicdn.com/img/ibank/O1CN01TBq9mG20s5Cn0RjFY_!!2208347006904-0-cib.jpg?__r__=1657679771488",
    306. "https://cbu01.alicdn.com/img/ibank/O1CN01RKhavh20s5CbAATJ4_!!2208347006904-0-cib.jpg?__r__=1657679771489",
    307. "https://cbu01.alicdn.com/img/ibank/O1CN013WRPcF20s5CiKa6cB_!!2208347006904-0-cib.jpg?__r__=1657679771489",
    308. "https://cbu01.alicdn.com/img/ibank/O1CN01Rls8Sr20s5Cg2aV1o_!!2208347006904-0-cib.jpg?__r__=1657679771489",
    309. "https://cbu01.alicdn.com/img/ibank/O1CN01cgBF9y20s5Cn0QaYg_!!2208347006904-0-cib.jpg?__r__=1657679771489",
    310. "https://cbu01.alicdn.com/img/ibank/O1CN01kuT9aM20s5CrILSmZ_!!2208347006904-0-cib.jpg?__r__=1657679771489",
    311. "https://cbu01.alicdn.com/img/ibank/O1CN01PEFGBF20s5Cs52UwI_!!2208347006904-0-cib.jpg?__r__=1657679791807",
    312. "https://cbu01.alicdn.com/img/ibank/O1CN01nvdG0z20s5CbAC9K0_!!2208347006904-0-cib.jpg?__r__=1657679791807",
    313. "https://cbu01.alicdn.com/img/ibank/O1CN01CdCMqj20s5CkdctYf_!!2208347006904-0-cib.jpg?__r__=1657679791807",
    314. "https://cbu01.alicdn.com/img/ibank/O1CN01GG52MQ20s5CkkadkW_!!2208347006904-0-cib.jpg?__r__=1657679791807",
    315. "https://cbu01.alicdn.com/img/ibank/O1CN013a5iRA20s5ChZphwR_!!2208347006904-0-cib.jpg?__r__=1657679791808",
    316. "https://cbu01.alicdn.com/img/ibank/O1CN015MOP2R20s5CtIrvIg_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    317. "https://cbu01.alicdn.com/img/ibank/O1CN01JBibtW20s5Cg2dWJm_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    318. "https://cbu01.alicdn.com/img/ibank/O1CN01wUoodX20s5CrIPgvo_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    319. "https://cbu01.alicdn.com/img/ibank/O1CN01bTYClX20s5CiKc3LA_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    320. "https://cbu01.alicdn.com/img/ibank/O1CN01BVHp9s20s5ClS6yYK_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    321. "https://cbu01.alicdn.com/img/ibank/O1CN01zm97EY20s5Cn0SwH2_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    322. "https://cbu01.alicdn.com/img/ibank/O1CN01XDMqpz20s5CrIP5W1_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    323. "https://cbu01.alicdn.com/img/ibank/O1CN01uZiVcz20s5CpFwWQy_!!2208347006904-0-cib.jpg?__r__=1657679818216",
    324. "https://cbu01.alicdn.com/img/ibank/O1CN013vnl8620s5ChZqNb4_!!2208347006904-0-cib.jpg?__r__=1657679818216"
    325. ],
    326. "shop_item": [],
    327. "relate_items": []
    328. },
    329. "error": "",
    330. "secache": "55ae58e80fe99c9b05e20b12d832cd3f",
    331. "secache_time": 1659421974,
    332. "secache_date": "2022-08-02 14:32:54",
    333. "translate_status": "",
    334. "translate_time": 0,
    335. "language": {
    336. "default_lang": "cn",
    337. "current_lang": "cn"
    338. },
    339. "reason": "",
    340. "error_code": "0000",
    341. "cache": 0,
    342. "api_info": "today:100 max:10100 all[168=100+30+38];expires:2030-12-31",
    343. "execution_time": "1.337",
    344. "server_time": "Beijing/2022-08-02 14:32:54",
    345. "client_ip": "106.6.35.126",
    346. "call_args": {
    347. "num_iid": "652014604299"
    348. },
    349. "api_type": "1688",
    350. "translate_language": "zh-CN",
    351. "translate_engine": "google_new",
    352. "server_memory": "3.99MB",
    353. "request_id": "gw-1.62e8c51595335",
    354. "last_id": "1122992565"
    355. }

  • 相关阅读:
    python调用函数详解
    【电源专题】开关电源的同步与非同步
    编译原理笔记01
    2023NOIP A层联测25-游戏
    图像处理技术:数字图像分割 ------ 图像分割、边界分割(边缘检测)、区域分割
    超聚变服务器关闭超线程CPU的步骤(完整版)
    什么是space-around
    【Linux】权限
    KITTI raw_data数据集百度云下载
    【Spring】开发框架Spring核心技术含Resource接口详细讲解
  • 原文地址:https://blog.csdn.net/Noah_ZX/article/details/126121879