API 列表

xiaodian.item.addItem

  • 免费
  • 需要授权

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

添加商品

公共参数

名称 类型 必选 描述
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:下架 0
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 Number 否 商详轮播图开关  0：关闭  1：开启
cycleImages Object[] 否 商详轮播图组
images String[] 否 组图
properties String 否 商品属性，例如“细节:拼接; 图案:粗条纹; 风格:日韩;”
brand String 否 商品品牌
supplier String 否 商品供应商
isCodItem Boolean 否 是否支持货到付款 false
onlineReservation Number 否 是否预约商品 0:支持所有预约 1:只支持付费预约 2:只支持免费预约 3:不支持预约 3

返回参数

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

请求参数示例

1).
{
	"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": "model_img"
	}],
	"isShelf": 0,
	"properties": {
		"风格": ["时尚", "日韩"]
	},
	"skus": [{
		"code": "sku编码",
		"price": 11.22,
		"stock": 1000,
		"style": "颜色"
	}],
	"tags": ["PCB", "标签2", "标签2"],
	"title": "时沙线下商品3",
	"refundAddress": {
		"province": "天津市",
		"city": "天津市",
		"area": "河北区",
		"address": "详细地址1",
		"name": "收件人1",
		"mobile": "13778878111"
	}
}
2).
{
  "userId": "",
  "item": {}
}

返回示例

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

异常示例

1).

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

API测试工具