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

dsc.product.insert.post (插入商品货品信息API)【默认模式】

插入货品信息API,获取货品相关信息。

公共参数

请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://www.xxx.com/api.php https://www.xxx.com/api.php
公共请求参数:
名称 类型 是否必须 描述
method String API接口名称
app_key String API接口AppKey

请求参数

名称 类型 是否必须 示例值 更多限制 描述
data array 必须 array('goods_id' => 154, 'goods_attr' => '519|528', 'product_sn' => '154HP0001', 'bar_code' => '154BAR0001', 'product_number' => 999) 转为JSON或XML 更新参数
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(json格式)
  • PHP(xml格式)
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.product.insert.post&format=json"
$Http = new Http();
 
$data=array(
<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>
)
 
$data = json_encode($data); // 对变量进行 JSON 编码
$argument=array(
'data' => $data
)
 
$Http->doPost($url, $argument);
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.product.insert.post&format=xml"
$Http = new Http();
 
$data = '<?xml version="1.0" encoding="utf-8"?>
<dsc>
"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",
</dsc>';
 
$data = htmlspecialchars($data); // 将特殊字符转换为 HTML 实体
$argument = array(
'data' => $data
);
 
$Http->doPost($url, $argument);

异常示例

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

错误码解释

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

0:数据提交成功

1:数据提交失败,参数不存在

2:存在不可传参的参数

3:已存在相同数据,无法添加

4:关键参数不存在或值为空

返回
顶部