90 lines
1.8 KiB
Markdown
90 lines
1.8 KiB
Markdown
# 商品查询接口
|
||
|
||
## 1. 商品列表（SKU）
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/product-aggregation/products/sku?pageNum=1&pageSize=10
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**Query 参数：**
|
||
- `pageNum`: 页码
|
||
- `pageSize`: 每页数量（建议不超过100）
|
||
- `keyword`: 可选，按商品名称模糊搜索
|
||
- `categoryId`: 可选，按分类ID筛选
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"totalCount": 1024,
|
||
"currentPage": 1,
|
||
"pageSize": 10,
|
||
"items": [
|
||
{
|
||
"skuId": 2116792188293408,
|
||
"spuId": 2116792188162336,
|
||
"code": "101-030-0008",
|
||
"name": "霜火果子（柿子+花生）",
|
||
"categoryId": 2116766652419584,
|
||
"categoryName": "水产生品类",
|
||
"brandId": 2116767991238144,
|
||
"brandName": "其他品牌",
|
||
"unitId": 2116753910024416,
|
||
"unitName": "个",
|
||
"status": 23,
|
||
"price": 9.3
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
**关键字段：**
|
||
- `skuId`: 商品SKU ID，用于库存查询
|
||
- `status`: 商品状态
|
||
|
||
---
|
||
|
||
## 2. 商品授权方案列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/product-aggregation/authorizations
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"totalCount": 4,
|
||
"items": [
|
||
{"id": 2116753910171872, "name": "默认授权方案"},
|
||
{"id": 2117317654711808, "name": "南宁分公司无商品"}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 3. skuId 增量更新列表（注意：调用报400参数错误，暂时跳过）
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/product-aggregation/sku/pull?pageNum=1&pageSize=10
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**⚠️ 状态：调用返回 `illegal parameters!`，参数格式待进一步排查。当前可跳过此接口，用商品列表代替。**
|
||
|
||
---
|
||
|
||
## 4. 价格等级列表
|
||
|
||
见 `basics.md` — `/product-aggregation/level-prices`
|