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": "明.郭"
}
]
}