万邦 Onebound alibaba.item.get 1688 商品详情 API（支持传入商品链接自动解析）
对接平台：万邦科技开放平台
控制台地址：https://console.open.onebound.cn/console/index.php?i=Lottie
接口名称：alibaba.item_get（1688 商品详情，获取 SKU 批发价、实时库存）
网关地址：https://api-gw.onebound.cn/1688/item_get
一、接口说明
支持直接传入完整 1688 商品链接，无需手动截取 itemId，接口底层自动解析；
返回完整 SKU 规格、阶梯批发价、活动价、实时库存、起订量；
适配货源监控、价格巡检、库存预警，搭配前文实时性优化方案使用。
二、Python 完整可运行代码（自带链接解析、SKU 打印、异常兜底）
importrequestsimportre# ===================== 配置项（替换你自己万邦后台密钥） =====================API_KEY="你的onebound后台key"API_GATEWAY="https://api-gw.onebound.cn/1688/item_get"# 你的1688商品链接，可直接修改替换goods_url="https://detail.1688.com/offer/7234567890123.html"# ==========================================================================def extract_offer_id(url):"""正则自动从1688链接提取商品offerId""" pattern=r"offer/(\d+)"res=re.search(pattern, url)ifres:returnres.group(1)returnNone def get_1688_goods_detail(goods_link,cache="no"):""" 调用万邦1688商品详情接口 :param goods_link: 完整1688商品url :param cache:no=实时最新数据，yes=缓存省额度（监控价格库存建议no） :return: 接口完整json数据""" item_id=extract_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: resp=requests.get(API_GATEWAY,params=params,timeout=15)returnresp.json()except Exception as e:return{"error":f"接口请求异常：{str(e)}"}if__name__=="__main__":print("=== 当前监控商品链接 ===")print(goods_url)print("========================\n")# cache=no 关闭缓存，保证价格库存实时result=get_1688_goods_detail(goods_url,cache="no")ifresult.get("error"): print("调用失败：", result["error"])elifresult.get("items")and len(result["items"])>0: item_data=result["items"][0]print(f"商品标题：{item_data.get('title')}")print("【SKU规格、价格、库存列表】")sku_list=item_data.get("sku",[])forskuinsku_list: spec_name=sku.get("sku_name","无规格")sku_price=sku.get("sku_price", sku.get("price"))stock=sku.get("stock_num",0)print(f"规格：{spec_name} | 批发价：{sku_price} | 实时库存：{stock}")else: print("未获取到商品数据，返回内容：", result)三、关键参数说明（贴合实时性优化）
cache=no
做价格、库存监控必须关闭缓存，每次请求拉平台实时数据，避免缓存滞后；日常静态信息查询可设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?i=Lottie 登录，复制后台 key 填入代码；
修改goods_url为你需要监控的 1688 商品链接；
安装依赖：pip install requests，直接运行脚本即可输出 SKU 实时价格库存；
批量监控可封装定时任务，搭配 Redis 做增量去重告警。
六、避坑提示
链接必须是标准detail.1688.com/offer/xxx格式，短链接、跳转链接会解析失败；
高频监控务必设置cache=no，否则会出现价格延迟、库存不准；
批量多商品轮询增加随机休眠，避免触发平台 429 限流。