文档中心 > API类目 > 商品货品API

dsc.product.info.get (获取单条商品货品信息API)【默认模式】

获取单条货品信息API,获取货品相关信息。

公共参数

请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://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
(不能单独使用)
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 货品警告库存

请求示例

  • PHP
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.product.info.get&product_sn=154HP0001&format=xml"
$Http = new Http();
$Http->doGet($url);

响应示例

  • XML
  • JSON
<dsc>
<info>
<product_id>1</product_id>
<goods_id>154</goods_id>
<goods_attr>519|528</goods_attr>
<product_sn>154HP0001</product_sn>
<bar_code>154BAR0001</bar_code>
<product_number>999</product_number>
<product_price>167.54</product_price>
<product_promote_price>146.2</product_promote_price>
<product_market_price>300</product_market_price>
<product_warn_number>20</product_warn_number>
</info>
</dsc>
{
"info": {
"product_id": "1",
"goods_id": "154",
"goods_attr": "519|528",
"product_sn": "154HP0001",
"bar_code": "154BAR0001",
"product_number": "999",
"product_price": "167.54",
"product_promote_price": "146.2",
"product_market_price": "300",
"product_warn_number": "20",
}
}

异常示例

  • XML
  • JSON
<dsc>
<result>success</result>
<error>0</error>
<msg>成功获取数据</msg>
</dsc>
{
"result": "success",
"error": 0,
"msg": "成功获取数据",
}

错误码解释

错误码 错误描述 解决方案
error 返回值

0:成功获取数据

1:数据为空值

2:条件为空或参数不存在

返回
顶部