文档帮助中心
dsc.product.area.list.get (获取商品地区货品列表API)【地区模式】
获取货品列表API，获取货品相关信息。
公共参数
请求地址：
公共请求参数：
| 环境 | HTTP请求地址 | HTTPS请求地址 |
|---|---|---|
| 正式环境 | https://www.xxx.com/api.php | https://www.xxx.com/api.php |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| method | String | 是 | API接口名称 |
| app_key | String | 是 | API接口AppKey |
请求参数
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| product_id | Number | 可选 | 货品ID | ||
| product_sn | Number | 可选 | （唯一性） | 货品编码 （建议同[goods_id]参数一起使用） | |
| goods_id | Number | 可选 | （非唯一性） | 商品ID | |
| area_id | Number | 可选 | （非唯一性） | 仓库地区ID （不能单独使用，获取仓库 dsc.warehouse.info.get 的region_id值） | |
| page | Number | 可选 | 1 | 默认 | 列表分页当前页 |
| page_size | Number | 可选 | 15 | 默认 | 列表分页每页显示条数 |
| format | type | 必须 | json | json或xml | 接口类型 |
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| product_id | Number | 货品ID | |
| goods_id | Number | 商品ID | |
| goods_attr | String | 519|528 | 属性ID名称（ID值拼接格式：519|528） |
| product_sn | String | 货品编码 | |
| bar_code | String | 货品条形码 | |
| product_number | Number | 货品库存 | |
| product_price | float | 货品价格 | |
| product_promote_price | float | 货品促销价 | |
| product_market_price | float | 货品市场价格 | |
| product_warn_number | Number | 货品警告库存 | |
| area_id | Number | 地区ID（对应仓库地区API：region_id，region_type 值为 1） |
请求示例
PHP
- $url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.product.area.list.get&format=xml"
- $Http = new Http();
- $Http->doGet($url);
错误码解释
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| error | 返回值 | 0：成功获取数据 1：数据为空值 |
