文档中心 > API类目 > 收货地�API

dsc.user.address.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('user_id' => 7, 'consignee' => '大商创', 'address' => '中山北路3553�伸大厦3层301室') 转为JSON或XML 更新�数
format type 必须 json json或xml 接�类型

�应�数

�称 类型 示例值 �述
address_id Number 收货地�ID
user_id Number 会员ID
consignee String 收货人�称
email String 邮箱
country Number 国家
province Number �份
city Number 市级
district Number 县级地区
street Number 乡镇街�
address String 收货地�
zipcode String 邮编
tel String �系电�
mobile String 手机��
sign_building String 地点标识:公��家里
best_time String 建议��时间
update_time Number æ›´æ–°æ—¶é—´

请求示例

  • PHP(jsonæ ¼å¼�)
  • PHP(xmlæ ¼å¼�)
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.user.address.insert.post&format=json"
$Http = new Http();
 
$data=array(
"user_id": "7",
"consignee": "大商创",
"country": "1",
"province": "310000",
"city": "659009504",
"district": "310107",
"street": "310107014",
"address": "中山北路3553�伸大厦3层301室",
"mobile": "18321*****4",
)
 
$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.user.address.insert.post&format=xml"
$Http = new Http();
 
$data = '<?xml version="1.0" encoding="utf-8"?>
<dsc>
<user_id>7</user_id>
<consignee>大商创</consignee>
<country>1</country>
<province>310000</province>
<city>659009504</city>
<district>310107</district>
<street>310107014</street>
<address>中山北路3553�伸大厦3层301室</address>
<mobile>18321*****4</mobile>
<sign_building>公�</sign_building>
</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:存在��传�的�数

6:�称值�能为空或传��称�存在

返回
顶部