dsc.user.rank.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

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rank_id Number 可选 2 (唯一性) 等级ID
rank_name String 可选 铜牌 (唯一性) 等级名称
data array 必须 array('rank_name'=>'铜牌', 'discount' => 70) 转为JSON或XML 更新参数
format type 必须 json json或xml 接口类型

响应参数

名称 类型 示例值 描述
rank_id Number 2 等级ID
rank_name String 金牌会员 等级名称
min_points Number 0 积分下限
max_points Number 10000 积分上限
discount Number 70 初始折扣率
show_price Number 1 在商品详情页显示该会员等级的商品价格
special_rank Number 1 特殊会员组特殊会员组的会员不会随着积分的变化而变化

请求示例

  • PHP(json格式)
  • PHP(xml格式)
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.user.rank.update.post&format=json"
$Http = new Http();
 
$data=array(
'rank_name' => '铜牌',
'min_points' => '0',
'max_points' => '10000',
'discount' => '100',
'show_price' => '1',
'special_rank' => '0',
)
 
$data = json_encode($data); // 对变量进行 JSON 编码
$argument=array(
'rank_id' => 2,
'data' => $data
)
 
$Http->doPost($url, $argument);
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.user.rank.update.post&format=xml"
$Http = new Http();
 
$data = '<?xml version="1.0" encoding="utf-8"?>
<dsc>
<rank_name>铜牌</rank_name>
<min_points>0</min_points>
<max_points>10000</max_points>
<discount>100</max_points>
<show_price>1</max_points>
<special_rank>0</special_rank>
</dsc>';
 
$data = htmlspecialchars($data); // 将特殊字符转换为 HTML 实体
$argument = array(
'rank_id' => 2,
'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:条件为空或参数不存在

4:当前数据不存在

5:存在不可传参的参数

6:当前名称数据已存在,无法更新

返回
顶部