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>

<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>

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

</dsc>

{

"result": "success",

"error": 0,

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

}

错误码解释

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

错误码

错误描述

解决方案

error

返回值

0：数据更新成功

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

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

4：当前数据不存在

5：存在不可传参的参数

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

返回
顶部

大商创开放平台

用户API