• 3522阅读
  • 5回复

【API|更新通知】关于商品API相关接口信息调整(涉及多个商品信息接口)重要

发帖
214
铜币
576
威望
91
贡献值
0
昵称
API技术支持TOP
— 本帖被 API技术支持TOP 执行取消加亮操作(2016-03-29) —
【API|更新通知】 关于商品API相关接口信息调整(涉及多个商品信息接口)

配合卖家产品业务需要,目前商品API相关接口做如下信息调整,请各位卖家及第三方开发者ISV了解,并相互转告!
谢谢配合!

具体接口变化情况说明:
1. api.findAeProductById接口
    该接口返回值"aeopAeProductSKUs"列表中每个元素新增参数"id"属性,由该唯一标示SKU。
    之后后编辑商品SKU相关属性值时(例如: 库存、价格等)只需要传这个"id"即可,而不再需要传整个SKU属性列表(skuProperties)。
2. api.postAeProduct接口的参数调整:
   a). 删除"summary"参数,系统不再需要这个参数。
   b). 删除"isImageDynamic"参数,系统会自动根据"imageURLs"参数中图片的数量来判断isImageDynamic是true还是false。
   c). 删除"src"参数,系统自动填充"isv"。
   d). 删除"isImageWatermark"参数,系统不在支持水印功能,如果卖家需要水印功能,请先对图片进行水印处理后再上传。
   e). aeopAeProductPropertys 该参数值说明内容更新
产品属性,以json格式进行封装后提交。参看aeopAeProductPropertys数据结构。此字段是否必填,需从类目接口getAttributesResultByCateId获取(即获取到的required来判断属性是否必填),该项只输入普通类目属性数据,不可输入sku类目属性。
对于类目属性包含子类目属性的情况,此处不确认父属性和子属性,即选择任何属性,都以该对象提交。
对于一个属性多个选中值的情况,以多个该对象存放。
其中"attrNameId","attrValueId"为整型(Integer), "attrName", "attrValue"为字符串类型(String)。
       i).  当设置一些系统属性时,如果类目自定义了一些候选值,只需要提供"attrNameId"和"attrValueId"即可。例如:{"attrNameId":494, "attrValueId":284}。
      ii). 当设置一些需要手工输入属性内容时,只需要提供"attrNameId"和"attrValue"即可。例如:{"attrNameId": 1000, "attrValue": "test"}
     iii)当设置自定义属性时,需要提供"attrName"和"attrValue"即可。例如: {"attrName": "Color", "attrValue": "red"}
     iv) 当设置一个Other属性时,需要提供"attrNameId", "attrValueId", "attrValue"三个参数。例如:{"attrNameId": 1000, "attrValueId": 4, "attrValue": "Other Value"}。
  
3. api.editAeProduct接口的参数调整:
       a). 删除"summary"参数,系统不再接受这个字段。
       b). 删除"isImageDynamic"参数,系统会自动根据"imageURLs"参数中图片的数量来判断isImageDynamic是true还是false。
       c). 删除"src"参数,系统自动填充"isv"。
       d). 删除"isImageWatermark"参数,系统不在支持水印功能,如果卖家需要水印功能,请先对图片进行水印处理后再上传。
       e). aeopAeProductPropertys 该参数值说明内容更新
产品属性,以json格式进行封装后提交。参看aeopAeProductPropertys数据结构。此字段是否必填,需从类目接口getAttributesResultByCateId获取(即获取到的required来判断属性是否必填),该项只输入普通类目属性数据,不可输入sku类目属性。
对于类目属性包含子类目属性的情况,此处不确认父属性和子属性,即选择任何属性,都以该对象提交。
对于一个属性多个选中值的情况,以多个该对象存放。
其中"attrNameId","attrValueId"为整型(Integer), "attrName", "attrValue"为字符串类型(String)。
      i).  当设置一些系统属性时,如果类目自定义了一些候选值,只需要提供"attrNameId"和"attrValueId"即可。例如:{"attrNameId":494, "attrValueId":284}。
      ii). 当设置一些需要手工输入属性内容时,只需要提供"attrNameId"和"attrValue"即可。例如:{"attrNameId": 1000, "attrValue": "test"}
     iii)当设置自定义属性时,需要提供"attrName"和"attrValue"即可。例如: {"attrName": "Color", "attrValue": "red"}
     iv) 当设置一个Other属性时,需要提供"attrNameId", "attrValueId", "attrValue"三个参数。例如:{"attrNameId": 1000, "attrValueId": 4, "attrValue": "Other Value"}。

4. 新增商品API相关接口
  api.editSingleSkuPrice(支持编辑商品单个SKU价格)、
  api.editSingleSkuStock(支持编辑商品单个SKU库存)、
  api.editMutilpleSkuStocks(支持编辑商品SKU可售库存),
   分别用于编辑单个SKU的价格、单个SKU库存、多个SKU的库存。
这三个接口与原来的(api.editSkuPrice、api.editSKUStock、api.editSKUStocks-即将安排6月初服务下线)一一对应,只是在参数部分做下调整,新的三个接口都只接受SKU ID参数,而不再需要传整个SKU属性列表。
   如果isv用到了这个三个接口,请切换到以上新接口进行调用。
SKU ID可以通过api.findAeProductById接口中的aeopAeproductSKUs中"id"进行获取。
见图示:

5. api.editSimpleProductFiled接口中fiedName参数说明:
   这个接口只支持以下属性的修改:subject(标题), detail(详描), deliveryTime(备货期), groupId(产品组), freightTemplateId(运费模版ID), packageLength(长), packageWidth(宽), packageHeight(高), grossWeight(毛重), wsValidNum(有效期), reduceStrategy(库存扣减策略)。
     以上相关接口信息变化即日起生效,请做好相关接口调用调整。






第三方工具市场 Fuwu.aliexpress.com



AliExpress速卖通开放平台          
2015.5.18          
[ 此帖被API技术支持TOP在2015-05-19 11:06重新编辑 ]
本帖最近评分记录: 2 条评分 铜币 +2 隐藏
爆款Q群#498633725 铜币 +1 2015-11-29 【速卖通0到100单秘籍】爆款打造方法,加QQ群:498633725领取,仅限前88名!
fan 铜币 +1 2015-09-05 出售速卖通【刷单技术】,一次付费终生享用,永久免费升级..Q:467553505
分享到:
级别: 精灵王
发帖
28
铜币
47
威望
20
贡献值
0
昵称
订单追踪宝
只看该作者 沙发  发表于: 2015-05-18
Re:【API|更新通知】 关于API相关接口信息调整(涉及多个商品信息接口) ..
与时俱进!
http://smt.khipusoft.com/
级别: 骑士
发帖
1
铜币
1
威望
1
贡献值
0
昵称
只看该作者 板凳  发表于: 2015-06-23
Re:【API|更新通知】关于商品API相关接口信息调整(涉及多个商品信息接口) ..
有没有速卖通的开发交流群啊,,,急求
级别: 精灵王
发帖
28
铜币
33
威望
28
贡献值
0
昵称
只看该作者 地板  发表于: 2015-07-12
Re:【API|更新通知】关于商品API相关接口信息调整(涉及多个商品信息接口) ..
c#  开发 路过
级别: 禁止发言
发帖
134
铜币
135
威望
130
贡献值
0
昵称
鼓鼓西里
只看该作者 4楼 发表于: 2015-08-07
用户被禁言,该主题自动屏蔽!
级别: 禁止发言
发帖
1010
铜币
1012
威望
1007
贡献值
0
昵称
爆款Q群#498633725
只看该作者 5楼 发表于: 2015-11-29
用户被禁言,该主题自动屏蔽!
描述
快速回复

您目前还是游客,请 登录注册
如果您在写长篇帖子又不马上发表,建议存为草稿