dsc.goods.area.update.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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
a_id	Number	可选		（唯一性）	商品地区ID
region_sn	String	可选		（唯一性）	商品地区货号
goods_id	Number	可选		（非唯一性）	商品ID，可根据 dsc.goods.info.get 获取（备注：建议搭配使用，增加信息准确性，不可单独使用）
seller_id	Number	可选		（非唯一性）	商家ID （备注：建议搭配使用，增加信息准确性，不可单独使用）
region_id	Number	可选		（非唯一性）	仓库地区ID，可根据 dsc.warehouse.info.get 获取（备注：建议搭配使用，增加信息准确性，不可单独使用）
format	type	必须	json	json或xml	接口类型

响应参数

名称	类型	描述
a_id	Number	商品地区ID
user_id	Number	商家ID
goods_id	Number	商品ID
region_id	Number	仓库地区ID
region_sn	String	商品地区货号
region_number	Number	商品地区库存数量
region_price	float	商品地区价格
region_promote_price	float	商品地区促销价格
give_integral	Number	赠送消费积分数
rank_integral	Number	赠送等级积分数
pay_integral	Number	积分购买金额
region_sort	Number	排序
add_time	String	添加时间
last_update	String	更新时间

请求示例

PHP(json格式)
PHP(xml格式)

$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.goods.area.update.post&format=json"

$Http = new Http();

$data=array(

'a_id' => '1',

'user_id' => '0',

'goods_id' => '594',

'region_id' => '2',

'region_sn' => 'SH594A0001',

'region_number' => '471',

'region_price' => '169.00',

'region_promote_price' => '126.00',

'give_integral' => '15',

'rank_integral' => '20',

'pay_integral' => '10'

)

$data = json_encode($data); // 对变量进行 JSON 编码

$argument=array(

'region_sn' => 'SH594A0001',

'data' => $data

)

$Http->doPost($url, $argument);

$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.goods.area.update.post&format=xml"

$Http = new Http();

$data = '<?xml version="1.0" encoding="utf-8"?>

<dsc>

<a_id>1</w_id>

<user_id>0</user_id>

<goods_id>594</goods_id>

<region_id>2</region_id>

<region_sn>SH594A0001</region_sn>

<region_number>471</region_number>

<region_price>169.00</region_price>

<region_promote_price>126.00</region_promote_price>

<give_integral>15</give_integral>

<rank_integral>20</rank_integral>

<pay_integral>10</pay_integral>

</dsc>';

$data = htmlspecialchars($data); // 将特殊字符转换为 HTML 实体

$argument = array(

'region_sn' => 'SH594A0001',

'data' => $data

);

$Http->doPost($url, $argument);

异常示例

XML
JSON

<dsc>

<result>success</result>

<msg>数据更新成功</msg>

</dsc>

{

"result": "success",

"error": 0,

"msg": "数据更新成功",

}

错误码解释

错误码	错误描述	解决方案
error	返回值	0：数据更新成功 1：数据提交失败,参数不存在 2：条件为空或参数不存在 3：已存在相同数据，无法更新 4：当前数据不存在 5：存在不可传参的参数

错误码

错误描述

解决方案

error

返回值

0：数据更新成功

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

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

3：已存在相同数据，无法更新

4：当前数据不存在

5：存在不可传参的参数

返回
顶部

大商创开放平台

商品API

dsc.goods.area.update.post (更新商品地区信息API)【地区模式】

公共参数

请求参数

响应参数

请求示例

异常示例

错误码解释