写点什么

1688 跨境代采业务用到的 API 接口及其使用示例

作者:tbapi
  • 2024-10-08
    江西
  • 本文字数:10590 字

    阅读完需:约 35 分钟

1688跨境代采业务用到的API接口及其使用示例

在电商领域,代采业务是一种常见的商业模式,特别是通过像 1688 这样的 B2B 平台。1688 为代采业务提供了丰富的 API 接口,以支持从商品搜索、详情获取到订单处理的全流程。本文将详细介绍在 1688 代采业务中常用的 API 接口,并提供 API 请求和响应的示例。

1. 常用的 1688 跨境代采业务 API

1.1 item_get - 获取商品详情

item_get API 是代采业务中最基础的接口之一,用于获取 1688 平台上商品的详细信息。

1.2 请求示例(https://console.open.onebound.cn/console/?i=andy

# coding:utf-8 """ Compatible for python2.x and python3.x requirement: pip install requests """ from __future__ import print_function import requests # 请求示例 url 默认请求参数已经做 URL 编码 url = "https://api-gw.Taobaoapi2014.cn/1688/item_get/?key=<您自己的 apiKey>&secret=<您自己的 apiSecret>&num_iid=610947572360" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)


1.3 响应示例

{    "item":{        "num_iid":601824709263,        "title":"韩版仿兔毛围巾秋冬毛毛围巾学生毛毛绒围脖冬季女套头防寒户外",        "desc_short":"",        "price":"2.2",        "total_price":0,        "suggestive_price":0,        "orginal_price":"2.2",        "nick":"_sopid@BBBEbRNm7OS0uGCXPJucMBy2w",        "num":3786174,        "min_num":2,        "detail_url":"https://detail.1688.com/offer/601824709263.html",        "pic_url":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg",        "brand":"",        "brandId":"",        "rootCatId":0,        "cid":325,        "crumbs":[
], "created_time":"", "modified_time":"", "delist_time":"", "desc":"<div id=\"offer-template-0\"></div><div > </div>\r\n<div ><span ><strong> <span >材质:双面仿兔毛毛绒面料,</span></strong></span></div>\r\n<div ><span ><strong><span >不掉毛(不是薄薄的单面哦)</span></strong></span></div>\r\n<div ><span ><strong ><span >厚款3.39元</span></strong></span></div>\r\n<div ><span ><strong><span ><span >普通款2.38元</span></span></strong></span></div>\r\n<div ><span ><strong><span ><span >每条围巾都是独立OPP袋子包装,放心选购!</span></span></strong></span></div>\r\n<div ><span ><strong><span >现货供应,厂家直销,没有中间商赚差价,有大量可以谈价,有量有价</span></strong></span></div>\r\n<div ><span ><strong><span >(抖音,快手,直播电商福利品,天猫,淘宝,PDD,跨境电商供应商)</span></strong></span></div>\r\n<div ><strong><span ><span ><span >这款围巾是不掉毛的,有些激光高温裁剪残留的浮毛,抖抖就好了哦。</span></span></span></strong></div>\r\n<div > </div>\r\n<div ><span ><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01emutXa27pyd6vYZzm_!!2206475177847-0-cib.jpg\" alt=\"undefined\"/><br/><strong>此图拉拉袋包装的为客户定做款(大货是OPP透明袋独立包装)</strong><br/><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01kFnNOl1MP9H5642lo_!!2272041426.jpg\" align=\"absmiddle\"/></span></div>\r\n<div ><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/TB2lZSUX7iHJuJjSZFjXXcGvXXa_!!2272041426.jpg\" align=\"absmiddle\"/><img src=\"https://img.alicdn.com/imgextra/i2/2272041426/TB2rvmVXYSGJuJjSZFqXXXo2pXa_!!2272041426.jpg\" align=\"absmiddle\"/></div>\r\n<div > </div>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01EKuyER1MP9LVqRODf_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01fH7zeu1MP9LXYMDb9_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01o03kWB1MP9LUPh2vD_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01zAl3p11MP9LTi5nZh_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01Zv9KBT1MP9LUIKRow_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01VlbKPj1MP9LU0NVFN_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01MjaoVZ1MP9LTiFjny_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01junsnm1MP9LX5bOdM_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i2/2272041426/O1CN014Dv2oq1MP9LU0KgIb_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01jNA7KZ1MP9LUHdDBF_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01JZW4Hn1MP9LUHd91D_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01nSbj2H1MP9LVqZ2mg_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01HmPSpT1MP9LSDyrsr_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p> </p>\r\n<div >..........</div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.65990d0ea4c43&p=1778786759&k=92716&t=1704529167\" style=\"display:none\" />", "desc_img":[ "https://cbu01.alicdn.com/img/ibank/O1CN01emutXa27pyd6vYZzm_!!2206475177847-0-cib.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01kFnNOl1MP9H5642lo_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/TB2lZSUX7iHJuJjSZFjXXcGvXXa_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i2/2272041426/TB2rvmVXYSGJuJjSZFqXXXo2pXa_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01EKuyER1MP9LVqRODf_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01fH7zeu1MP9LXYMDb9_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01o03kWB1MP9LUPh2vD_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i4/2272041426/O1CN01zAl3p11MP9LTi5nZh_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01Zv9KBT1MP9LUIKRow_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01VlbKPj1MP9LU0NVFN_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i4/2272041426/O1CN01MjaoVZ1MP9LTiFjny_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i4/2272041426/O1CN01junsnm1MP9LX5bOdM_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i2/2272041426/O1CN014Dv2oq1MP9LU0KgIb_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i4/2272041426/O1CN01jNA7KZ1MP9LUHdDBF_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01JZW4Hn1MP9LUHd91D_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i3/2272041426/O1CN01nSbj2H1MP9LVqZ2mg_!!2272041426.jpg", "https://img.alicdn.com/imgextra/i4/2272041426/O1CN01HmPSpT1MP9LSDyrsr_!!2272041426.jpg" ], "item_imgs":[ { "url":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg" }, { "url":"https://cbu01.alicdn.com/img/ibank/11921665153_1818272533.jpg" }, { "url":"https://cbu01.alicdn.com/img/ibank/11884953047_1818272533.jpg" }, { "url":"https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg" }, { "url":"https://cbu01.alicdn.com/img/ibank/12483429103_1818272533.jpg" } ], "item_weight":"", "item_size":"", "location":"浙江省 金华市", "post_fee":"", "express_fee":"", "ems_fee":"", "shipping_to":"", "has_discount":"", "video":"https://cloud.video.taobao.com/play/u/2206475177847/p/1/e/6/t/1/238604472723.mp4", "is_virtual":"", "sample_id":"", "is_promotion":"", "props_name":"0:0:颜色:红色;0:1:颜色:黑色;0:2:颜色:白色;0:3:颜色:灰色;0:4:颜色:杏色;0:5:颜色:粉色;0:6:颜色:咖啡色;0:7:颜色:米色;0:8:颜色:卡其色", "prop_imgs":{ "prop_img":[ { "properties":"0:0", "url":"https://cbu01.alicdn.com/img/ibank/11884977080_1818272533.jpg" }, { "properties":"0:1", "url":"https://cbu01.alicdn.com/img/ibank/11954549680_1818272533.jpg" }, { "properties":"0:2", "url":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg" }, { "properties":"0:3", "url":"https://cbu01.alicdn.com/img/ibank/11921680795_1818272533.jpg" }, { "properties":"0:4", "url":"https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg" }, { "properties":"0:5", "url":"https://cbu01.alicdn.com/img/ibank/11921689268_1818272533.jpg" }, { "properties":"0:6", "url":"https://cbu01.alicdn.com/img/ibank/11954552765_1818272533.jpg" }, { "properties":"0:7", "url":"https://cbu01.alicdn.com/img/ibank/O1CN01PtW77W27pyekEhcAt_!!2206475177847-0-cib.jpg" }, { "properties":"0:8", "url":"https://cbu01.alicdn.com/img/ibank/O1CN01t2Q1ci27pyjXB0fxo_!!2206475177847-0-cib.jpg" } ] }, "property_alias":"0:0:红色;0:1:黑色;0:2:白色;0:3:灰色;0:4:杏色;0:5:粉色;0:6:咖啡色;0:7:米色;0:8:卡其色", "props":[ { "name":"品牌", "value":"高着" }, { "name":"编织方法", "value":"经编" }, { "name":"功能", "value":"保暖" }, { "name":"适合季节", "value":"冬季" }, { "name":"货号", "value":"WJ618" }, { "name":"产地", "value":"浙江义乌" }, { "name":"款式", "value":"中长" }, { "name":"颜色", "value":"红色" }, { "name":"颜色", "value":"黑色" }, { "name":"颜色", "value":"白色" }, { "name":"颜色", "value":"灰色" }, { "name":"颜色", "value":"杏色" }, { "name":"颜色", "value":"粉色" }, { "name":"颜色", "value":"咖啡色" }, { "name":"颜色", "value":"米色" }, { "name":"颜色", "value":"卡其色" }, { "name":"主要下游平台", "value":"淘宝" }, { "name":"主要下游平台", "value":"京东" }, { "name":"主要下游平台", "value":"ebay" }, { "name":"主要下游平台", "value":"亚马逊" }, { "name":"主要下游平台", "value":"wish" }, { "name":"主要下游平台", "value":"快手" }, { "name":"主要下游平台", "value":"速卖通" }, { "name":"主要下游平台", "value":"天猫" }, { "name":"主要下游平台", "value":"独立站" }, { "name":"主要下游平台", "value":"LAZADA" }, { "name":"主要下游平台", "value":"拼多多" }, { "name":"主要下游平台", "value":"抖音" }, { "name":"有可授权的自有品牌", "value":"否" }, { "name":"是否跨境出口专供货源", "value":"是" }, { "name":"上市年份/季节", "value":"2021年秋季" }, { "name":"宽度(CM)", "value":"12cm" }, { "name":"风格", "value":"百搭" }, { "name":"风格", "value":"优雅" }, { "name":"风格", "value":"极简" }, { "name":"风格", "value":"休闲风" }, { "name":"风格", "value":"时尚OL" }, { "name":"风格", "value":"简约" }, { "name":"风格", "value":"欧美" }, { "name":"风格", "value":"轻奢风" }, { "name":"风格", "value":"chic风" }, { "name":"风格", "value":"高级感" }, { "name":"面料名称", "value":"毛绒" }, { "name":"风格分类", "value":"时尚通勤" }, { "name":"处理工艺", "value":"经编" }, { "name":"流行元素分类", "value":"无" } ], "total_sold":3786174, "skus":{ "sku":[ { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:0", "properties_name":"0:0:颜色:红色", "quantity":0, "sku_id":5330445855404, "spec_id":"87b07b1e746bd546e97a0f5888726ae3" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:1", "properties_name":"0:1:颜色:黑色", "quantity":0, "sku_id":5330445855410, "spec_id":"e664b2e7c4adae52d35767f51a9219f6" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:2", "properties_name":"0:2:颜色:白色", "quantity":0, "sku_id":5330445855398, "spec_id":"18dc5ba8c7dc3df0eb8b731977df2372" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:3", "properties_name":"0:3:颜色:灰色", "quantity":8020, "sku_id":5330445855408, "spec_id":"05808df6001a6ffa6fa13ae7df588b36" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:4", "properties_name":"0:4:颜色:杏色", "quantity":0, "sku_id":5330445855412, "spec_id":"1ab2b4cd3cc2b51ed4055978ca4b8579" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:5", "properties_name":"0:5:颜色:粉色", "quantity":0, "sku_id":5330445855402, "spec_id":"7a394d5d7d8560fae263cd2ffe9ee444" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:6", "properties_name":"0:6:颜色:咖啡色", "quantity":0, "sku_id":5330445855396, "spec_id":"423651c0792f75de75484ae9bd5fe535" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:7", "properties_name":"0:7:颜色:米色", "quantity":0, "sku_id":5330445855400, "spec_id":"45b9c574ac45662aba79f2cb72d20112" }, { "price":4.99, "total_price":4.99, "orginal price":4.99, "properties":"0:8", "properties_name":"0:8:颜色:卡其色", "quantity":0, "sku_id":5330445855406, "spec_id":"f7931f4b9892a8c41b76205cb1d50627" } ] }, "seller_id":null, "sales":0, "shop_id":null, "props_list":{ "0:0":"颜色:红色", "0:1":"颜色:黑色", "0:2":"颜色:白色", "0:3":"颜色:灰色", "0:4":"颜色:杏色", "0:5":"颜色:粉色", "0:6":"颜色:咖啡色", "0:7":"颜色:米色", "0:8":"颜色:卡其色" }, "seller_info":{ "nick":null, "user_num_id":null, "sid":null, "title":null, "zhuy":null, "shop_name":null }, "tmall":"false", "error":"", "warning":"", "url_log":[
], "unit":null, "is_support_mix":null, "mix_amount":null, "mix_begin":null, "mix_number":null, "priceRange":[ [ 2, "2.2" ] ], "priceRangeOriginal":[
], "_ddf":"sop", "props_img":{ "0:0":"https://cbu01.alicdn.com/img/ibank/11884977080_1818272533.jpg", "0:1":"https://cbu01.alicdn.com/img/ibank/11954549680_1818272533.jpg", "0:2":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg", "0:3":"https://cbu01.alicdn.com/img/ibank/11921680795_1818272533.jpg", "0:4":"https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg", "0:5":"https://cbu01.alicdn.com/img/ibank/11921689268_1818272533.jpg", "0:6":"https://cbu01.alicdn.com/img/ibank/11954552765_1818272533.jpg", "0:7":"https://cbu01.alicdn.com/img/ibank/O1CN01PtW77W27pyekEhcAt_!!2206475177847-0-cib.jpg", "0:8":"https://cbu01.alicdn.com/img/ibank/O1CN01t2Q1ci27pyjXB0fxo_!!2206475177847-0-cib.jpg" }, "sales_info":{ "seller_num":"", "repeat_rate_purchase":"", "per_capita_purchases":"", "comment_num":"", "comment_url":"" }, "format_check":"ok", "shop_item":[
], "relate_items":[
] }, "error":"", "secache":"a1950f8cc13611671db129a5c7ae864a", "secache_time":1704529167, "secache_date":"2024-01-06 16:19:27", "translate_status":"", "translate_time":0, "language":{ "default_lang":"cn", "current_lang":"cn" }, "reason":"", "error_code":"0000", "cache":0, "api_info":"today:28 max:10000 all[28=28+0+0];expires:2024-05-30", "execution_time":"0.342", "server_time":"Beijing/2024-01-06 16:19:27", "client_ip":"106.6.33.199", "call_args":{ "num_iid":"601824709263" }, "api_type":"1688", "server_memory":"0.92MB", "request_id":"gw-4.65990d0ea4c43", "last_id":"2436414138"}
复制代码

1.4 其他常用 API

  • item_fee:获取商品快递费用

  • seller_info:获取店铺详情

  • item_search_shop:获取店铺的所有商品

  • item_password:获得淘口令真实 URL

  • upload_img:上传图片到 1688

  • item_search_seller:搜索店铺列表

  • img2text:图片识别商品接口

  • buyer_order_list:获取购买到的商品订单列表

总结

通过 1688 提供的丰富 API 接口,代采业务可以实现从商品搜索、详情获取到订单处理的全流程自动化。上述示例仅展示了部分常用 API 的请求和响应结构,实际使用中应根据具体需求选择相应的 API,并参考 1688 开放平台接口文档进行详细开发。

用户头像

tbapi

关注

记录日常代码积累,交流Taobaoapi2014 2023-07-06 加入

记录日常代码积累,交流Taobaoapi2014,分享每一份成功的喜悦。

评论

发布
暂无评论
1688跨境代采业务用到的API接口及其使用示例_1688代采系统_tbapi_InfoQ写作社区