1. 公告
  2. 2022年好单库开放平台—淘系商品ID(itemid)升级公告

2022年好单库开放平台—淘系商品ID(itemid)升级公告

发布日期:2022-07-08 浏览:



好单库开放平台
淘系商品ID升级公告


01
商品ID升级背景

     联盟为了提升淘宝客软件服务及相关工具服务的数据安全保障、服务管理能力优化体验,将会对商品ID进行全面升级,好单库基于联盟升级工作,将同步升级商品ID,为大家提供更完善的产品能力和精细化的服务能力

02

商品ID升级简介


一、商品ID由静态数字变为动态变化的字符串

      升级后的商品ID将变为动态变化的字符串,淘宝客每次转链、获取物料等接口交互行为出参的商品ID均会发生变化;


二、商品ID长度变化

      升级后的商品ID整体长度最长为50位,升级后的商品ID示例:fjdashkhie-r89juoiu,前段和后段间由“-”相连接;


三、商品ID规则变化

     升级后的商品ID(示例:fjdashkhie-r89juoiu)中“-”的前半段为每次交互都会变化的字符串,“-”的后半段为对单个Member账号同商品在特定范围内不变(范围可能有周期等因素)的字符串;


四、淘宝客订单明细变化

     订单明细里商品ID将升级为同member+同商品的商品ID在特定范围内不变(范围可能有周期等因素);

03

好单库商品ID整改方案


     因我们前期接口大部分商品ID输出的都为字符串类型,所以改动相对比较小,并且我们提供不同版本的接口数据帮助大家进行平滑切换,尽量减少大家的改动,以最小的代价帮助大家升级完成,所以我们只要一次升级即可调整到位,届时我们所有接口字段名itemid不变,变的将会是itemid的内容,大家只要将字段的原内容调用转链接口即可,其他不受影响,具体升级内容如下:


3.1接口/单页调整时间



01
2022年7月15日

接口返回数据itemid由integer类型转为String类型;

02
2022年8月15日 — 2022年8月30

以上时间为接口切换过渡期,可通过新增入参v=3.7.12获取加密后的itemid数据;

03
2022年8月31日

各淘系商品相关接口返回数据商品ID(itemid)将变为加密后新商品ID(长度50个字符以内);届时商品搜索接口、转链接口、商品详情接口不再支持“数字”商品ID传参的方式。

【示例】

调整前:

itemid:“676541933100”

item_url:“https://detail.tmall.com/item.htm?id=676541933100”

调整后:

itemid:“0P9xktGkMXyIxVVu629wrcK-2KxQwVtMMmKJmB6IZ”,

item_url:“https://uland.taobao.com/item/edetail?id=0P9xktGkMXyIxVVu629-2KxQwVtMMmKJmB6IZ”


3.2涉及相关接口



接口名称接口地址

淘宝订单查询

(订单号查询)

https://kurl02.cn/DXnsY
淘宝订单拉取https://kzurl05.cn/DXnJb
淘宝超级搜索https://kzurl09.cn/DXnqP
商品列表页APIhttps://kzurl19.cn/DXTXk
各大榜单APIhttps://kzurl16.cn/DXTiN
今日值得买APIhttps://kzurl09.cn/DXTYg
04

相关资料


4.1淘宝联盟工具服务商业务升级通知

https://kzurl05.cn/Duqgi


4.2【商品ID升级】白皮书:

https://kurl02.cn/DuqF8

END