游戏的对局和货币等信息上报接口
1 URL
https://[域名/IP]/v3/message/openreport_bill
正式环境域名或测试环境IP详见:API3.0文档#请求URL说明。
2 格式
JSON
3 HTTP请求方式
GET
4 IP限制
TRUE
5 输入参数说明
各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明。
(2)公共私有参数
参数名称 |
类型 |
参数含义 |
可选/必选 |
billtype |
int |
账单类型:1代表对局账单,2代表货币账单 【注意】:billtype的值不同,决定后续参数的数量不同,具体见以下定制私有参数 |
必选 |
billtype=1的时候,后续私有参数如下:
参数名称 |
类型 |
参数含义 |
可选/必选 |
fcount |
int |
此字段为下面的fx的字段数量 |
必选 |
f1 | string(32) |
对局流水的字符串信息标识 |
必选 |
f2 |
int |
对局耗时,单位为秒 |
必选 |
f3 |
int |
当前积分点数(累积) |
必选 |
f4 |
int |
当前财富值(累积) |
必选 |
f5 |
int |
游戏的GameType |
必选 |
f6 |
int |
获得积分点数(本局) |
必选 |
f7 |
int |
胜局次数(本局)0/1 |
必选 |
f8 |
int |
负局次数(本局)0/1 |
必选 |
f9 |
int |
平局次数(本局)0/1 |
必选 |
f10 |
int |
逃跑次数(本局)0/1 |
必选 |
f11 |
int |
游戏的MoneyType |
必选 |
f12 |
int |
当局的Money流水,可为负(包含逃跑费) |
必选 |
f13 |
int |
当局赢的Money |
必选 |
f14 |
int |
当局输的Money |
必选 |
f15 |
int |
逃跑扣费 |
必选 |
f16 |
int |
游戏币、欢乐豆、麻辣豆的抽水额(本局,当前是固定台费) |
必选 |
f17 |
int |
游戏币、欢乐豆、麻辣豆等抽水额(本局,比如5%) |
必选 |
f18 |
int |
本局底分 |
必选 |
f19 |
int |
本局开场倍数 |
必选 |
f20 |
int |
本局结算倍数 |
必选 |
f21 |
int |
结果码Result,默认为0表示成功 |
必选 |
f22 |
string(32) |
游戏参数串,主要用于描述房间计分特殊性 |
必选 |
f23 |
int |
房间标识roomflag |
必选 |
f24 |
int |
该房间组织的活动ID,0-无活动,1000000-某个活动 |
必选 |
billtype=2的时候,后续私有参数如下:
参数名称 |
类型 |
参数含义 |
可选/必选 |
fcount |
int |
此字段为下面的fx的字段数量 |
必选 |
f1 | string(32) |
对局流水的字符串信息标识 |
必选 |
f2 |
int |
货币值的变化量 |
必选 |
f3 |
int |
货币值变化后的总量 |
必选 |
6 请求示例
https://119.147.19.43/v3/message/openreport_bill?openid=000000000000000000000000032373DF&openkey=39DBE00A043F8DB011391759A3A8A250A453B88C079C516CB4AAC0F4691C931F3679B97D0A61560569095307220E4D2210DE35F24BF630F25DE6A290994A8735&appid=28240&pf=qqgame&sig=e3evlGSde+JQ0AodlAn5RoX6InA=
7 返回参数说明
参数名称 |
类型 |
含义 |
ret |
int |
详见公共返回码 |
msg |
string |
错误描述 |
8 正确返回示例
{
"ret":0,
"msg":"操作成功!",
}
9 错误返回示例
参见公共错误返回示例