# 商品查询接口

## 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`