万邦 Onebound alibaba.item.get 1688 商品详情 API（支持传入商品链接自动解析）

对接平台万邦科技开放平台控制台地址https://console.open.onebound.cn/console/index.php?iLottie接口名称alibaba.item_get1688 商品详情获取 SKU 批发价、实时库存网关地址https://api-gw.onebound.cn/1688/item_get一、接口说明支持直接传入完整 1688 商品链接无需手动截取 itemId接口底层自动解析返回完整 SKU 规格、阶梯批发价、活动价、实时库存、起订量适配货源监控、价格巡检、库存预警搭配前文实时性优化方案使用。二、Python 完整可运行代码自带链接解析、SKU 打印、异常兜底importrequestsimportre# 配置项替换你自己万邦后台密钥 API_KEY你的onebound后台keyAPI_GATEWAYhttps://api-gw.onebound.cn/1688/item_get# 你的1688商品链接可直接修改替换goods_urlhttps://detail.1688.com/offer/7234567890123.html# def extract_offer_id(url):正则自动从1688链接提取商品offerId patternroffer/(\d)resre.search(pattern, url)ifres:returnres.group(1)returnNone def get_1688_goods_detail(goods_link,cacheno): 调用万邦1688商品详情接口 :param goods_link: 完整1688商品url :param cache:no实时最新数据yes缓存省额度监控价格库存建议no :return: 接口完整json数据 item_idextract_offer_id(goods_link)ifnot item_id:return{error:商品链接解析失败请检查url格式}params{key:API_KEY,api_name:item_get,id:item_id,cache:cache,# 只拉取SKU动态字段提升实时性fields:sku,title,price,stock,promotion_price}try: resprequests.get(API_GATEWAY,paramsparams,timeout15)returnresp.json()except Exception as e:return{error:f接口请求异常{str(e)}}if__name____main__:print( 当前监控商品链接 )print(goods_url)print(\n)# cacheno 关闭缓存保证价格库存实时resultget_1688_goods_detail(goods_url,cacheno)ifresult.get(error): print(调用失败, result[error])elifresult.get(items)and len(result[items])0: item_dataresult[items][0]print(f商品标题{item_data.get(title)})print(【SKU规格、价格、库存列表】)sku_listitem_data.get(sku,[])forskuinsku_list: spec_namesku.get(sku_name,无规格)sku_pricesku.get(sku_price, sku.get(price))stocksku.get(stock_num,0)print(f规格{spec_name} | 批发价{sku_price} | 实时库存{stock})else: print(未获取到商品数据返回内容, result)三、关键参数说明贴合实时性优化cacheno做价格、库存监控必须关闭缓存每次请求拉平台实时数据避免缓存滞后日常静态信息查询可设yes节省调用额度。id支持两种传参①纯数字 offerId ②完整商品链接代码内已自动解析。fields只保留 sku、price、stock 等动态字段减少返回冗余数据提升响应速度。四、配套业务落地说明承接上文实时性方案分层缓存本地 Redis 缓存商品标题、规格名称30 分钟SKU 价格、库存仅缓存 10 秒大促直接不缓存。分级轮询爆款 30s~1min 轮询普通商品 3-5min滞销商品 10-15min异步队列错峰调用防限流。SKU 增量比对以 sku_id 作为唯一标识对比历史库存 / 价格变动后推送告警并二次复核过滤网络抖动假数据。异常兜底代码内置 15s 超时捕获接口异常保留上一轮缓存数据展示同时记录日志排查。五、使用步骤打开万邦控制台https://console.open.onebound.cn/console/index.php?iLottie 登录复制后台 key 填入代码修改goods_url为你需要监控的 1688 商品链接安装依赖pip install requests直接运行脚本即可输出 SKU 实时价格库存批量监控可封装定时任务搭配 Redis 做增量去重告警。六、避坑提示链接必须是标准detail.1688.com/offer/xxx格式短链接、跳转链接会解析失败高频监控务必设置cacheno否则会出现价格延迟、库存不准批量多商品轮询增加随机休眠避免触发平台 429 限流。