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