跳到主要内容

子商户投注记录（拉取最近）

1、子商户投注记录（拉取最近）​

接口路径​

  • Get
  • /api/game/transaction/sub/latest

说明​

  • 查询总商户下子商户的最新注单
  • 按最后时间，拉取最新注单
  • 一次最多可拉 1000 笔资料
  • 投注订单根据订单「更新时间」排序
  • 请接续上次拉账最后一笔「更新时间」为搜寻起始时间
  • 注意：若某次取值无订单，则将下次取值设为现在时间的前一分钟

接口频率说明​

  • 查询投注记录 api 调用最多 5 秒钟调用 1 次

请求参数​

参数名称类型必填说明
agent_id商户 IDstring必填总商户 ID，用于验证签名
sub_agent_id子商户 IDstring选填指定子商户 ID，不传则返回所有直接子商户的注单
last_time最后时间string必填单位毫秒
timestamp当前时间戳int必填传调用接口时的时间戳（单位毫秒，有效期十分钟）
sign签名string必填签名算法详见接口说明

说明​

  • agent_id 为总商户 ID，必须传，用于验证白名单与签名
  • 传 sub_agent_id 时，接口会验证该子商户是否归属于 agent_id，非直接子商户会返回参数错误
  • 不传 sub_agent_id 时，返回 agent_id 下所有直接子商户的注单
  • sub_agent_id 参与签名计算（有值时需加入签名）

响应参数​

参数名称类型说明
code响应码int错误码
message响应信息string错误信息
data响应数据dict响应数据详情
--transactions投注订单列表List投注订单列表
----id订单 IDstring订单 ID
----game_id游戏 IDstring游戏 ID， 101: 百家乐
----user_id用户 IDstring用户 ID
----inst_id台桌 IDstring台桌 ID
----shoe_id牌靴 IDint牌靴 ID
----round_id牌局 IDlong牌局 ID
----bet_time投注时间int投注时间
----settle_time结算时间int结算时间
----bet_amount投注金额string投注金额
----real_bet_amount有效投注金额string有效投注金额
----valid_bet_turnover有效流水string有效流水，去掉对压金额以及和局金额
----win_amount派彩金额string派彩金额
----real_win_amount真实输赢金额string真实输赢金额 = 派彩金额 - 投注金额
----currency币种string币种
----bet_detail投注详情dict投注详情，字典的 key 是投注项目，值是投注金额
----win_detail派彩详情dict派彩详情，字典的 key 是投注项目，值是派彩金额
----no_comm是否免佣boolean是否免佣
----game_result游戏结果Array游戏结果
----open_cards开牌牌面dictbanker:庄, player:闲, result:游戏结果
----create_time订单创建时间int订单创建时间
----update_time订单更新时间int订单更新时间
----status订单状态int0-已下注，1-已结算，2-用户取消，3-订单无效，4-结算改无效

投注项说明​

投注项说明
Tie和
Banker庄
Player闲
Big大
Small小
PlayerPair闲对
BankerPair庄对
Super6幸运 6
PDragonBonus闲龙宝
BDragonBonus庄龙宝
AnyPair任意对子
PerfectPair完美对子
PlayerNatural闲例牌
BankerNatural庄例牌

牌面说明​

  • 开牌牌面，按开牌顺序依次拼接成字符串
  • 例如，闲第一张牌红桃 A、第二张牌梅花 6、第三张牌方块 J，拼接字符串为"HeartsA,Clubs6,DiamondsJ"
花色说明
Hearts红桃
Diamonds方块
Clubs梅花
Spades黑桃

请求范例（指定子商户）​

curl --location 'https://staging.aig1234.com/api/game/transaction/sub/latest?agent_id=agent001&sub_agent_id=sub001&last_time=1732589000000&timestamp=1734417236278&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json'

请求范例（所有直接子商户）​

curl --location 'https://staging.aig1234.com/api/game/transaction/sub/latest?agent_id=agent001&last_time=1732589000000&timestamp=1734417236278&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json'

响应范例​

{
    "code": 200,
    "message": "success",
    "data": {
        "transactions": [
            {
                "id": "67453d0923c36d2571d40815",
                "user_id": "7797",
                "game_id": "101",
                "inst_id": "iN95KcYR",
                "shoe_id": 10907,
                "round_id": 9,
                "bet_time": 1732590857359,
                "settle_time": 1732590881164,
                "bet_amount": "100",
                "real_bet_amount": "100",
                "valid_bet_turnover": "100",
                "win_amount": "200.00",
                "currency": "USD",
                "real_win_amount": "100.00",
                "bet_detail": {
                    "Banker": 100
                },
                "win_detail": {
                    "Banker": "200.00"
                },
                "no_comm": true,
                "game_result": [
                    "Banker",
                    "Big"
                ],
                "open_cards": {
                    "banker": "Spades9,Hearts5",
                    "player": "Clubs7,Clubs7,DiamondsA"
                },
                "create_time": 1732590857359,
                "update_time": 1732590857359,
                "status": 1
            }
        ]
    }
}

错误码​

200 成功
408000 请求参数错误
408003 白名单限制
408004 API频率限制
600100 签名不合法
600101 参数不合法
700101 商户不存在