3. jiace开放平台商品管理

3.1. 获取选品商品信息列表

Type: POST

Author: lones

Content-Type: application/json; charset=utf-8

Description: 获取选品商品信息列表

Body-parameters:

Parameter Type Description Required Since

keyWords

string

关键字

false

-

categoryId

int64

商品类目id

false

-

pageNo

int32

当前页

false

-

pageSize

int32

每页条数

false

-

Request-example:

curl -X POST -H 'Content-Type: application/json; charset=utf-8' -i /openapi/goods/goodsList --data '{
	"keyWords": "upuorq",
	"categoryId": 341,
	"pageNo": 15,
	"pageSize": 10
}'

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

object

No comments found.

-

└─searchCount

boolean

进行 count 查询 【 默认: true 】

-

└─pages

int64

当前分页总页数

-

└─hitCount

boolean

是否命中count缓存

-

└─records

array

查询数据列表

-

     └─goodsId

int64

商品id

-

     └─subject

string

商品名称

-

     └─mainImagesUrl

string

商品主图,

-

     └─referencePrice

int32

批发价格,单位为分

-

     └─consignPrice

number

分销基准价。代销场景均使用该价格。

-

     └─bookedCount

int32

30天销量

-

     └─createTime

string

创建时间

-

     └─updateTime

string

更新时间

-

└─total

int64

总数

-

└─size

int64

每页显示条数,默认 10

-

└─current

int64

当前页

-

└─orders

array

排序字段信息

-

     └─column

string

需要进行排序的字段

-

     └─asc

boolean

是否正序排列,默认 true

-

└─optimizeCountSql

boolean

自动优化 COUNT SQL

-

└─isSearchCount

boolean

是否进行 count 查询

-

└─countId

string

countId

-

└─maxLimit

int64

countId

-

Response-example:

{
	"code": 635,
	"message": "success",
	"data": {
		"searchCount": true,
		"pages": 949,
		"hitCount": true,
		"records": [
			{
				"goodsId": 234,
				"subject": "z9nabx",
				"mainImagesUrl": "www.xn---xn--wg3a-k13qt896b.biz",
				"referencePrice": 162,
				"consignPrice": 20,
				"bookedCount": 938,
				"createTime": "2023-05-07 22:48:59",
				"updateTime": "2023-05-07 22:48:59"
			}
		],
		"total": 498,
		"size": 510,
		"current": 49,
		"orders": [
			{
				"column": "bro8wz",
				"asc": true
			}
		],
		"optimizeCountSql": true,
		"isSearchCount": true,
		"countId": "121",
		"maxLimit": 461
	}
}

3.2. 获取选品商品信息详情

Type: GET

Author: lones

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 获取选品商品信息详情

Query-parameters:

Parameter Type Description Required Since

goodsId

int64

No comments found.

true

-

Request-example:

curl -X GET -i /openapi/goods/goodsDetail?goodsId=147

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

object

No comments found.

-

└─id

int64

No comments found.

-

└─goodsId

int64

商品ID

-

└─subject

string

商品名称

-

└─goodsResource

int32

商品来源,默认是 3,1:拼多多,2:小红书,3:1688

-

└─skuInfoList

array

sku 列表

-

     └─id

int64

id

-

     └─goodsId

int64

商品id

-

     └─skuId

string

sku编码

-

     └─specId

string

自定义规格ID

-

     └─attributes

array

sku属性列表

-

          └─attributeID

string

No comments found.

-

          └─attributeName

string

sku属性ID所对应的显示名,比如颜色,尺码

-

          └─attributeValue

string

属性值内容

-

          └─skuImageUrl

string

sku图片

-

     └─thumbUrl

string

sku预览图

-

     └─cargoNumber

string

指定规格的货号

-

     └─price

number

sku批发价格

-

     └─retailPrice

number

零售价,团长业务使用此价格

-

     └─skuStatus

int32

上下架状态1:上架2:下架3删除

-

     └─quantit

int32

库存

-

     └─delFlag

int32

是否删除,1:否,2:是

-

     └─createTime

string

创建时间

-

     └─updateTime

string

更新时间

-

└─attributes

array

商品属性和属性值[{"attributeID":属性ID,"attributeName":属性名称,"value":属性值,"valueID":属性值ID}

-

└─bizType

int32

业务类型。1:商品,2:加工,3:代理,4:合作,5:商务服务。国际站按默认商品。

-

└─bookedCount

string

成交量

-

└─cargoNum

string

商品货号,产品属性中的货号

-

└─categoryId

int64

类目ID,标识商品所属类目

-

└─categoryName

string

类目名

-

└─description

string

商品详情描述,可包含图片中心的图片URL

-

└─detailVedio

string

详情视频

-

└─images

array

商品轮播图["https://cbu01.alicdn.com/trext.img","https://cbu01.alicdn.com/trext2.img"]

-

└─mainImagesUrl

string

主图

-

└─mainVedio

string

主图视频播放地址

-

└─referencePrice

string

参考价格,返回价格区间,可能为空

-

└─sevenDaysRefunds

int32

是否支持七天无理由退货,1:是,2:否

-

└─goodsStatus

int32

商品状态,1:上架,2:下架,3:禁售'

-

└─delFlag

int32

是否删除,0:否,1:是

-

└─createTime

string

创建时间

-

└─updateTime

string

更新时间

-

Response-example:

{
	"code": 3,
	"message": "success",
	"data": {
		"id": 809,
		"goodsId": 307,
		"subject": "765buj",
		"goodsResource": 70,
		"skuInfoList": [
			{
				"id": 745,
				"goodsId": 822,
				"skuId": "264543d1-1df5-4709-9a7f-3b194f028304",
				"specId": "121",
				"attributes": [
					{
						"attributeID": "121",
						"attributeName": "明.郭",
						"attributeValue": "8rkav7",
						"skuImageUrl": "www.xn---xn--wg3a-k13qt896b.biz"
					}
				],
				"thumbUrl": "www.xn---xn--wg3a-k13qt896b.biz",
				"cargoNumber": "3rhnaz",
				"price": 174,
				"retailPrice": 469,
				"skuStatus": 989,
				"quantit": 83,
				"delFlag": 8,
				"createTime": "2023-05-07 22:48:59",
				"updateTime": "2023-05-07 22:48:59"
			}
		],
		"attributes": [
			{
				"mapKey": {
					
				}
			}
		],
		"bizType": 7,
		"bookedCount": "t9mzi3",
		"cargoNum": "v8moj4",
		"categoryId": 233,
		"categoryName": "明.郭",
		"description": "s1zg5k",
		"detailVedio": "v3as07",
		"images": [
			"9d1k0o"
		],
		"mainImagesUrl": "www.xn---xn--wg3a-k13qt896b.biz",
		"mainVedio": "5dzreo",
		"referencePrice": "4yxizw",
		"sevenDaysRefunds": 988,
		"goodsStatus": 233,
		"delFlag": 8,
		"createTime": "2023-05-07 22:48:58",
		"updateTime": "2023-05-07 22:48:58"
	}
}

3.3. 根据父类ld查询子类目列表

Type: GET

Author: lones

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 根据父类ld查询子类目列表

Query-parameters:

Parameter Type Description Required Since

categoryId

int64

No comments found.

false

-

Request-example:

curl -X GET -i /openapi/goods/getCategoryInfo?categoryId=513

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

array

No comments found.

-

└─categoryId

int64

类目id

-

└─categoryName

string

分类名称

-

Response-example:

{
	"code": 283,
	"message": "success",
	"data": [
		{
			"categoryId": 944,
			"categoryName": "明.郭"
		}
	]
}