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   作者:漫漫