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