三方回调

三方回调接口用于我方主动与第三方服务器交互，通过同一个接口，根据不同的 cmd 参数执行不同逻辑。接口设计支持自动重试机制和鉴权校验。

POST 三方回调--查询余额

POST /api/v4/threePartyCallback

我方主动请求三方服务器获取数据。 如果返回status不是200，默认会重试，5次重试失败则放弃调用。

同时也会附带appid，appkey，如需鉴权，可以比对appid，appkey

Body 请求参数

{
  "cmd": "game.wallet.get",
  "data": {
    "ctype": "GOLD",
    "uid": "129404059592429568"
  }
}

请求参数

名称	位置	类型	必选	中文名	说明
auth	header	string	否		none
body	body	object	否		none
» cmd	body	string	是	请求命令	默认：game.wallet.get
» data	body	object	是	请求数据	none
»» ctype	body	string	是	货币类型	none
»» uid	body	string	是	用户id	none

返回示例

200 Response

{
  "code": 200,
  "msg": "",
  "data": {
    "ctype": "GOLD",
    "amount": 1000000
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	状态码	响应状态码 200为成功，非200为失败
» msg	string	true	none	响应信息	响应返回信息
» data	object	true	none	响应数据	none
»» ctype	string	true	none	货币类型	none
»» amount	integer	true	none	钱包余额	none

POST 三方回调--投注结算

POST /api/v4/threePartyCallback

我方主动请求三方服务器获取数据。 如果返回status不是200，默认会重试，5次重试失败则放弃调用。

同时也会附带appid，appkey，如需鉴权，可以比对appid，appkey

Body 请求参数

{
  "cmd": "game.bet.order",
  "data": {
    "gid": "139",
    "ctype": "GOLD",
    "uid": "7",
    "roundId": "55",
    "orderId": "77",
    "bei": 21,
    "rid": 86,
    "count": 55,
    "abei": 23,
    "bet": 100,
    "actualBet": 100,
    "win": 100
  }
}

请求参数

名称	位置	类型	必选	中文名	说明
auth	header	string	否		none
body	body	object	否		none
» cmd	body	string	是	请求命令	none
» data	body	object	是	请求数据	none
»» gid	body	string	是	游戏id	none
»» ctype	body	string	是	货币类型	none
»» uid	body	string	是	用户id	none
»» roundId	body	string	是	游戏子回合id	none
»» orderId	body	string	是	一局游戏的唯一id	none
»» bei	body	integer	是	每个回合的倍率	none
»» rid	body	integer	是	一局游戏的回合索引	none
»» count	body	integer	是	一局游戏的回合总数	none
»» abei	body	integer	是	当前轮次所有回合的总倍率，如果每个回合没结算完，总倍率会有偏差。	none
»» bet	body	integer	是	投注金额	none
»» actualBet	body	integer	是	实际投注金额	none
»» win	body	integer	是	中奖额，保留2位小数	none

返回示例

200 Response

{
  "code": 200,
  "err": null,
  "data": {
    "uid": "7",
    "gid": "139",
    "balance": "2000.00",
    "preBalance": "1900.00",
    "done": true
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	响应码	响应状态码 200为成功非200为失败
» err	null	true	none	错误信息	none
» data	object	true	none	响应数据	none
»» uid	string	true	none	用户id	none
»» gid	string	true	none	游戏id	none
»» balance	string	true	none	结算后的余额	none
»» preBalance	string	true	none	结算前的余额	none
»» done	boolean	true	none	结算成功	none
»» pay	number	false	none	总充值金额	例：20
»» tags	string	false	none	策略标签	英文逗号分隔，例："a,d"

POST 三方回调--干预结果

POST /api/v4/threePartyCallback

我方主动请求三方服务器获取数据。 如果返回status不是200，默认会重试，5次重试失败则放弃调用。

同时也会附带appid，appkey，如需鉴权，可以比对appid，appkey

Body 请求参数

{
  "cmd": "game.bet.order",
  "data": {
    "gid": "139",
    "ctype": "gold",
    "uid": "7",
    "roundId": "55",
    "orderId": "77",
    "bei": 21,
    "rid": 86,
    "count": 55,
    "abei": 23,
    "bet": 100,
    "actualBet": 100,
    "win": 100
  }
}

请求参数

名称	位置	类型	必选	中文名	说明
auth	header	string	否		none
body	body	object	否		none
» cmd	body	string	是	请求命令	默认：game.bet.modify
» data	body	object	是	请求数据	none
»» mid	body	string	是	干预id	客户自己生成
»» gid	body	string	是	游戏id	none
»» ctype	body	string	是	货币类型	none
»» uid	body	string	是	用户id	none
»» roundId	body	string	是	一局游戏的唯一id	none
»» orderId	body	string	是	游戏子回合id	none
»» bei	body	integer	是	每个回合的倍率	none
»» rid	body	integer	是	一局游戏的回合索引	none
»» count	body	integer	是	一局游戏的回合总数	none
»» abei	body	integer	是	当前轮次所有回合的总倍率，如果每个回合没结算完，总倍率会有偏差。	none
»» bet	body	integer	是	投注金额	none
»» actualBet	body	integer	是	实际投注金额	none
»» win	body	integer	是	中奖额，保留2位小数	none

返回示例

200 Response

{
  "code": 200,
  "err": null,
  "data": {
    "uid": "7",
    "gid": "139",
    "setProfit": 2,
    "balance": "2300.00",
    "setFb": "1",
    "preBalance": "2300.00",
    "isModify": true,
    "fb": "1",
    "done": false
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	响应码	响应状态码 200为成功，非200为失败
» err	null	true	none	错误信息	为空级正确返回
» data	object	true	none	响应数据	none
»» uid	string	true	none	用户id	none
»» gid	string	true	none	游戏id	none
»» setProfit	integer	true	none	游戏获奖倍率	none
»» balance	string	true	none	结算后的余额	none
»» setFb	string	true	none	设置是否免费	none
»» preBalance	string	true	none	结算前的余额	none
»» isModify	boolean	true	none	干预是否成功	none
»» fb	string	true	none	是否免费	奖项类型 fb=0 表示普通奖， fb=1 表示页数奖
»» done	boolean	true	none	是否	none
»» pay	number	false	none	总充值金额	例：20
»» tags	string	false	none	策略标签	英文逗号分隔，例："a,d"