## 商品 / **商品查詢**（*oms.goods.query*）
###### 最后更新日期：**2024-04-10 12:00:00**
*****
### **API描述**
接入方調用該接口，進行商品查詢。
*****
### **公共參數說明**
| 參數名稱 | 類型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| app\_key | String(32) | 是 | 接入方AppKey，由平臺對接人員提供 | |
| method | String(128) | 是 | 接口名稱 | oms.goods.query |
| version | String(10) | 是 | 接口版本 | 1.0 |
| biz\_content | Text | 是 | 業務參數的集合，并以**JSON格式**表示，并做urlencode處理，最大長度不限 | |
| sign | String(32) | 是 | 請求參數簽名值，參考【簽名加密】 | |
### **biz\_content參數說明**
| 參數名稱 | 類型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| goods_type | String | 是 | 商品類型：NORMAL-普通，DISTRIBUTION-分銷商品 | NORMAL |
| page_size | Int | 是 | 分頁記錄數（最大20條） | 20 |
| page_no | Int | 是 | 分頁頁碼 | 1 |
```
biz_content參數原文樣例：
{"goods_type":"DISTRIBUTION","page_size":20,"page_no":1}
urlencode轉碼后：
%7B%22goods_type%22%3A%22DISTRIBUTION%22%2C%22page_size%22%3A20%2C%22page_no%22%3A1%7D
```
*****
### **響應參數說明**
| 參數名稱 | 類型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| code | Int| 是 | 響應代碼（0為成功，非0有異常） | 0 |
| msg | String | 是 | 響應描述 | success |
| data | Object | 是 | 響應數據 | |
### **data參數說明**
| 參數名稱 | 類型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| item_list | Object | 是 | 商品數據體 | |
| total_count |Int| 是 | 商品記錄數 | 115 |
### **item_list參數說明**
| 參數名稱 | 類型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| goods\_sku | String | 是 | 商品規格編碼 | B48970026 |
| sku\_name | String | 是 | 商品名稱 | 益生菌膠囊 |
```
{
"code": 0,
"msg": "success",
"data": {
"item_list": [
{
"goods_sku": "B48970026",
"sku_name": "WONDERLAB女性益生菌膠囊30粒"
},
{
"goods_sku": "B48970064",
"sku_name": "WONDERLAB男士多維片60粒"
},
{
"goods_sku": "B73502930",
"sku_name": "BioGaia拜奧Gastrus咀嚼片30粒"
},
{
"goods_sku": "B93162654",
"sku_name": "Brauer蓓澳兒兒童新配方鈣鎂鋅200ml"
},
{
"goods_sku": "B93163852",
"sku_name": "Brauer蓓澳兒兒童高純度DHA軟膠囊60粒"
}
],
"total_count": 115
}
}
```
