1. 写入金币
本地论坛自研程序调用此接口写入金币获取或消耗事件
当read接口返回-2(用户不存在),此接口传入username、avatar可以新增用户,并添加金币
请求地址
POST http://{hostname}.adm.qianfanyun.com/api/gold/write
请求参数
参数名称 |
类型 |
必填 |
说明 |
uid |
int |
是 |
用户ID |
username |
string |
是 |
用户名(read接口返回-2时,必传) |
avatar |
string |
是 |
头像(read接口返回-2时,必传) |
desc |
string |
是 |
说明 |
num |
int |
是 |
金币数量变化,正数或负数 |
type |
int |
是 |
金币变动的类型(大于1024的类型) |
nonce |
string |
是 |
随机字符串 |
sign |
string |
是 |
签名 |
返回内容
字段 |
类型 |
说明 |
status |
int |
结果码 |
text |
string |
原因 |
data |
array |
返回的数据(array(‘uid’=&用户id(int),’username’=&用户名(string),’avatar’=&用户头像链接(string),’gold’=&账户金币数量(int),’result’=&结果(bool))) |
2. 查询用户金币数量
本地论坛自研程序调用此接口查询指定用户金币数量
请求地址
POST http://{hostname}.adm.qianfanyun.com/api/gold/read
请求参数
参数名称 |
类型 |
必填 |
说明 |
uid |
int |
是 |
用户ID |
nonce |
string |
是 |
随机字符串 |
sign |
string |
是 |
签名 |
返回内容
字段 |
类型 |
说明 |
status |
int |
结果码(1:成功;0:失败;-1:签名错误;-2:用户不存在) |
text |
string |
返回结果 |
data |
array |
返回的数据(array(‘uid’=&用户id(int),’username’=&用户名(string),’avatar’=&用户头像链接(string),’gold’=&账户金币数量(int)) |
####2.1 批量查询用户金币数量
本地论坛自研程序调用此接口查询指定用户金币数量
请求地址
POST http://{hostname}.adm.qianfanyun.com/api/gold/readlot
请求参数
参数名称 |
类型 |
必填 |
说明 |
uid |
string |
是 |
用户ID字符串(uid,uid,uid) |
nonce |
string |
是 |
随机字符串 |
sign |
string |
是 |
签名 |
返回内容
字段 |
类型 |
说明 |
status |
int |
结果码 |
text |
string |
返回结果 |
data |
array |
返回的数据) |
3. 获取用户金币及等级相关信息接口
请求地址
POST http://{hostname}.adm.qianfanyun.com/api/gold/info
请求参数
参数名称 |
类型 |
必填 |
说明 |
uid |
int |
是 |
用户ID |
nonce |
string |
是 |
随机字符串 |
sign |
string |
是 |
签名 |
返回内容
字段 |
类型 |
说明 |
status |
int |
状态码(-2:用户不存在;-1:参数校验失败;0:错误;1:正确) |
text |
string |
返回的相关信息 |
data |
string |
status == 1时返回的数据 |
data说明:
字段 |
说明 |
username |
用户名 |
gold_num |
用户金币 |
assign_str |
用户连续签到天数 |
is_assign |
用户当天是否已签到(0:否;1:是) |
ugradenum |
用户等级 |
umale |
用户有性别版男等级名称 |
ufemale |
用户有性别版女等级名称 |
usecrecy |
用户有性别版保密等级名称 |
文档更新时间: 2019-10-31 15:57 作者:漫漫