QQ游戏开放平台

欢迎来到QQ游戏开放平台 登录| 管理中心 | 开发者论坛

/v3/message/openreport_bill

目录

游戏的对局和货币等信息上报接口


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的值不同,决定后续参数的数量不同,具体见以下定制私有参数

必选
(3)定制私有参数

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 错误返回示例

参见公共错误返回示例


联系我们 向上
回到顶部