接口作用:拿到1688 手机 APP 端原始返回 JSON,不是经过封装整理后的简化数据,保留 APP 客户端渲染页面的原始大对象,适合拿 APP 才有的隐藏字段、完整 SKU 模型、价格模块、组件数据。
请求地址
https://api-gw.onebound.cn/1688/item_get_app
请求参数
公共参数:key、secret、api_name=item_get_app、cache、result_type 等
业务参数
num_iid:必填,1688 商品 ID
cache=no:和搜索接口一样,关闭缓存拿实时 APP 原始数据;cache=yes 走缓存速度快,数据会滞后
示例请求串
https://api-gw.onebound.cn/1688/item_get_app?key=xxx&secret=xxx&num_iid=商品id&cache=no
和 item_get 的核心区别
item_get:平台做过二次清洗整理,返回扁平化结构化字段,title、price、sku、pic_url,业务开发直接读取,简单好用;但是部分 APP 端独有的字段被过滤掉。
item_get_app:透传 APP 返回原始数据包,返回大嵌套对象 globalData、skuModel、skuRangePrices、shareModel 等原始组件结构。
优点:能拿到 APP 上才展示的阶梯价格、分销规则、组件、弹窗、活动标签; 缺点:返回结构层级很深,字段杂乱,有很多前端组件配置垃圾字段,需要自己解析提取业务值;平台改版 APP 页面时返回结构会变动,要适配。
适合什么场景
item_get 拿不到真实多档阶梯价、代发价、特殊活动价格时;
需要复刻 1688 APP 详情页渲染,拿到原始组件数据;
ERP、铺货系统,需要抓取 APP 端展示的完整价格模型;
排查问题:对比网页 H5 和 APP 端商品数据差异。
不适合
快速业务开发,优先用 item_get;item_get_app 原始结构经常随 1688 APP 升级变动,解析代码需要维护。
返回简要结构
外层固定 code/message,核心数据在返回结果里面:
globalData:商品主体原始信息
skuModel:完整 SKU 选择模型(APP 选规格组件原始数据)
skuRangePrices:多档位价格区间原始对象
shareModel:店铺、分享相关信息
还附带一堆前端组件配置,这些业务可以直接忽略。
提示:如果开启 cache=no,每次请求都会拉取实时 APP 数据,耗时会比普通 item_get 略高。