API 列表

xiaodian.item.addItem.v2

  • 免费
  • 需要授权

API功能描述(支持get和post)

添加商品2

公共参数

名称 类型 必选 描述
app_key Long 是 接入时申请的app_key
method String 是 接口名称
access_token String 是 Oauth2.0授权获得的access_token
sign String 是 对 API 调用参数（除sign外）进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 是 时间戳，使用Unix时间戳格式
format String 是 响应格式。默认为json格式，固定
sign_method String 否 参数的加密方法选择，当前只支持Md5
version String 否 API协议版本，固定值为：1.0

输入参数

名称 类型 必选 描述 示例值
item Object 是 商品数据
title String 是 商品标题
description String 是 商品描述
classIds String[] 否 店铺内分类id
decStockType Number 是 1下单减库存，0付款减库存
cid String 是 （叶子）类目id
code String 否 商品编码
isShelf Number 是 0:上架，1:下架
brandId String 否 品牌id
coverImages String[] 是 封面图数组(默认取第一张图为商品主图)
skus Object[] 是 sku数据
image String 是 sku图片（默认sku不传图则为商品主图）
stock Number 是 库存
code String 是 sku编码
price Number 是 价格
style String 否 款式
size String 否 尺码
attrs Object[] 否 sku属性
name String 否 属性名,比如：颜色
value String 否 属性值，比如：黑色
props Object[] 否 尺码对照信息（map/字典类型）
key String 否 尺码对照属性值，比如：腰围
value Object[] 否 尺码信息
name String 否 属性名，比如：腰围
values String[] 否 属性值：比如：66
brandCode String 否 品牌编码(天美意专用)
colorCode String 否 颜色编码(天美意专用)
costPrice Number 否 成本价，如8.88，单位元
minActivityPrice Number 否 活动最低价,如8.88,单位元
cycleSkuImgs String[] 否 sku轮播图
postage Object 否 运费模版数据
tplId String 否 运费模版id
weight String 否 重量
volume String 否 体积
details Object[] 是 商品详情模块数据
slug String 是 模块英文名称，自定义模块格式：custom_module_0_＋模块名称，比如：custom_module_0_服装效果
desc String 是 模块描述
imageDescs Object[] 否 图片列表
path String 否 图片相对路径
detailCycleImg Object 否 商详轮播图
cycleSwitch String 否 商详轮播图开关  0：关闭  1：开启
cycleImages Object[] 否 商详轮播图组
images String[] 否 组图
properties String 否 商品属性，例如“细节:拼接; 图案:粗条纹; 风格:日韩;”
brand String 否 商品品牌
supplier String 否 商品供应商
isCodItem Boolean 否 是否支持货到付款 false
onlineReservation Number 否 是否预约商品 0:支持所有预约 1:只支持付费预约 2:只支持免费预约 3:不支持预约 3
itemSpecList Object 是 规格属性
specificationValue String 是 规格值
itemSpecification Object 是 规格信息
specificationParam Object[] 否 规格参数
key String 否 规格参数-名称
value String[] 否 规格参数-值
filterLabelMap Object 否 规格筛选标签
searchLabelMap Object 否 规格搜索标签

返回参数

名称 类型 描述 默认值
data String 添加成功后的itemId

请求参数示例

1).
{
	"userId": 325497729,
	"item": {
		"cid": "15dq",
		"code": "a1b2",
		"coverImages": ["/p1/160120/176s0c_ie4wgmldha3tqnjtgyzdambqgqyde_640x960.jpg", "/p1/160120/176s0c_ie4wgmldha3tqnjtgyzdambqgqyde_640x960.jpg"],
		"decStockType": 1,
		"description": "商品的描述",
		"details": [{
			"desc": "模特图",
			"imageDescs": [{
				"path": "/p1/160120/176s0c_ie4wgmldha3tqnjtgyzdambqgqyde_640x960.jpg"
			}],
			"slug": "detail_img"
		}],
		"isShelf": 0,
		"properties": {
			"风格": ["时尚", "日韩"]
		},
		"skus": [{
				"code": "sku编码",
				"price": 11.22,
				"stock": 1000,
				"style": "黑色"
			},
			{
				"code": "sku编码",
				"price": 11.22,
				"stock": 1000,
				"style": "红色"
			}
		],
		"tags": ["PCB", "标签2", "标签2"],
		"title": "诺守测试商品11",
		"refundAddress": {
			"province": "天津市",
			"city": "天津市",
			"area": "河北区",
			"address": "详细地址1",
			"name": "收件人1",
			"mobile": "13778878111"
		},
		"itemSpecList": [{
			"specificationValue": "黑色",
			"itemSpecification": {
				"specificationParam": [{
					"key": "参数1",
					"value": ["AA", "BB"]
				}, {
					"key": "参数2",
					"value": ["AA", "BB"]
				}],
				"filterLabelMap": {
					"包袋": ["手提包", "斜挎包"],
					"测试": ["test1", "test2"]
				},
				"searchLabelMap": {
					"包袋": ["手提包", "斜挎包"],
					"测试": ["test1", "test2"]
				}
			}
		}, {
			"specificationValue": "红色",
			"itemSpecification": {
				"specificationParam": [{
					"key": "参数1",
					"value": ["AA", "BB"]
				}, {
					"key": "参数2",
					"value": ["AA", "BB"]
				}],
				"filterLabelMap": {
					"包袋": ["手提包", "斜挎包"],
					"测试": ["test1", "test2"]
				},
				"searchLabelMap": {
					"包袋": ["手提包", "斜挎包"],
					"测试": ["test1", "test2"]
				}
			}
		}]
	}
}
2).
{ "userId": "", "item": {} }
3).
{
		"cid": "15dq",
		"code": "a1b2",
		"coverImages": ["https://s5.mogucdn.com/mlcdn/c45406/210712_163dd14ikeeg13df60l7k4ebkhg22_750x750.png", "https://s5.mogucdn.com/mlcdn/c45406/210712_163dd14ikeeg13df60l7k4ebkhg22_750x750.png"],
		"decStockType": 1,
		"description": "商品的描述",
		"details": [{
			"desc": "商详主图",
			"imageDescs": [{
				"path": "https://s5.mogucdn.com/mlcdn/c45406/210712_163dd14ikeeg13df60l7k4ebkhg22_750x750.png"
			}],
			"slug": "detail_img"
		}],
		"isShelf": 0,
		"skus": [{
				"code": "sku编码",
				"price": 11.22,
				"stock": 1000,
				"style": "黑色"
			},
			{
				"code": "sku编码",
				"price": 11.22,
				"stock": 1000,
				"style": "红色"
			}
		],
		"tags": ["PCB", "标签2", "标签2"],
		"title": "ns测试商品01",
		"refundAddress": {
			"province": "天津市",
			"city": "天津市",
			"area": "河北区",
			"address": "详细地址1",
			"name": "收件人1",
			"mobile": "13778878111"
		},
		"itemSpecList": [{
			"specificationValue": "黑色",
			"itemSpecification": {
			}
		}, {
			"specificationValue": "红色",
			"itemSpecification": {
			}
		}]
	}

返回示例

1).
{ "result": { "data": "18kahta" }, "status": { "code": "0000000", "msg": "" } }

异常示例

1).
{ "result": { "data": {} }, "status": { "code": "1100403", "msg": "无权限访问该商品" } }

API测试工具