文档中心 > API类目 > 盒马接力go对接API

qimen.alibaba.wdk.vertical.nb.item.sync (nb商品同步)

盒马nb商品信息同步到三方

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
itemDTO	ItemDTO	可选			入参
└ reservePrice Number 必须 100 保底价格（即价格） └ mainItemTotalSoldQuantity Number 可选 100 总销量 └ channelShopId Number 必须 124 渠道店id └ description String 可选 <p><img src="https://img.alicdn.com/imgextra/i1/263685747/O1CN01ZQnJmC1sKArxUb0Rq_!!263685747.jpg"></p> 描述图片链接 └ commodityId Number 可选 1234 品类id └ title String 可选苹果主题 └ categoryName String 可选水果类目name └ duration Number 可选 14 有效天数，只对拍卖品有效 └ itemId Number 必须 123456 商品id └ subTitle String 可选乳霜纸子主题 └ icTags String 必须 11,22,33,44 商品标 itemImages ItemImages [] 可选图片相关 └ imageUrl String 可选 //img.alicdn.com/i2/263685747/O1CN01SkgoF81sKArvmyumb_!!263685747.jpg 图片链接 └ isMajor Boolean 可选 true 是否是主图 └ imageId Number 可选 1234 图片id └ auctionStatus Number 必须 0 商品状态 └ descPath String 可选 desc/icoss3987646090189e93a5610bb051 描述地址，不可直接用 └ auctionType String 可选 e 商品类型a拍卖b一口价e团购 └ categoryId Number 必须 2234 类目id └ specification String 可选 400g/个商品规格 └ skuCode String 必须 123 skucCode └ increment Number 可选 1 加购步长 └ startWith Number 可选 1 起购数量 └ saleUnit String 可选个销售单位 └ skuId Number 必须 1234 skuId └ outShopType String 可选 HYD 外部商户类型（ZTNB/HYD） └ isPinTuan Boolean 可选 false 是否拼团 └ warehouseCode String 可选 1 仓

响应参数

名称	类型	示例值	描述
success	Boolean	false	返回结果
errorMessage	String	参数校验失败	错误原因
errorCode	String	10001	错误码
data	Body		返回结果
└ outItemId String 23434 外部商品id

请求示例

{"itemDTO":{"reservePrice":100,"description":"<p><img src=\"https://img.alicdn.com/imgextra/i1/263685747/O1CN01ZQnJmC1sKArxUb0Rq_!!263685747.jpg\"></p>","increment":1,"title":"苹果","categoryName":"水果","saleUnit":"个","warehouseCode":"1","duration":14,"subTitle":"乳霜纸","icTags":"11,22,33,44","itemImages":[{"imageId":1234,"imageUrl":"//img.alicdn.com/i2/263685747/O1CN01SkgoF81sKArvmyumb_!!263685747.jpg","isMajor":true}],"isPinTuan":false,"auctionType":"e","startWith":1,"skuId":1234,"mainItemTotalSoldQuantity":100,"channelShopId":124,"specification":"400g/个","commodityId":1234,"itemId":123456,"auctionStatus":0,"descPath":"desc/icoss3987646090189e93a5610bb051","outShopType":"HYD","categoryId":2234,"skuCode":"123"}}

响应示例

{
    "success":false,
    "errorMessage":"参数校验失败",
    "errorCode":"10001",
    "data":{
        "outItemId":"23434"
    }
}

验签示例

{"success":"false","errorMessage":"Illegal request","errorCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

盒马接力go对接API

qimen.alibaba.wdk.vertical.nb.item.sync (nb商品同步)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ