#

SUD

简要描述

  • 批量创建订单

请求URL

请求方式

  • 传输协议：HTTPS
  • 请求方法：POST
  • 参数以body传递，格式为json（见请求示例）
  • Header中需要添加：Content-Type: application/json;charset=utf-8
  • Header中需要添加：认证请求头 Authorization

请求头 [Authorization]

请求参数

参数名 必选 类型 说明
mg_id 是 string 游戏id
room_id 是 string 房间id
orders 是 BatchCreateOrderEntry[] 订单数据 数组
  • BatchCreateOrderEntry
参数名 必选 类型 说明
out_order_id 是 string 商户自定义唯一订单号id (64个字符以内)
cmd 是 string 触发的行为动作
from_uid 是 string 付费用户uid
from_nickname 否 string 付费用户昵称
from_avatar_url 否 string 付费用户头像
to_uid 是 string 目标用户uid
value 是 int32 所属的游戏价值
random 否 bool 是否随机 (当to_uid不在玩家列表中时是否随机玩家触发，不填则默认为false)
true: 随机玩家触发， false: 执行失败
payload 否 object 附加数据 (游戏客户端透传给app客户端有该参数值时需要原样透传)

  • 游戏 cmd | value | payload 参数对应表：

1.排雷兵，游戏ID=1472142640866779138

cmd value cmd附加数据(payload) 说明
change_hand 具体的价格 更换手牌，每局开始时可以最多更换1次
gift_cover_clouds 示例：{"count":1,"count_limit":20,"show_time":50}
count：数量，默认为1
count_limit: 数量上限，默认为20
show_time: 显示时间，默认为20秒		 飘云
gift_cover_big_chain 示例：{"show_time": 10}
show_time：显示时间，默认为10秒		 大锁链
gift_windy 示例：{"count":1}
count： 飘走云数量，默认为1		 刮风
gift_discover_big_chain 解锁
gift_exchange_hands 手牌互换
gift_add_card 加一张手牌
gift_del_card 减一张手牌
gift_give_remove_card 送拆雷牌
gift_give_throw_card 送扔雷牌
gift_next_bomb 换雷
gift_free_change_hand 免费换手牌

2.美式8球, 游戏ID=1739914495960793090

cmd value cmd附加数据(payload) 说明
gift_increase_friction 示例："payload":{"count":5} 绿草如茵-增大摩擦力
gift_decrease_friction 示例："payload":{"count":5} 千里冰封-减小摩擦力
gift_fake_black_8 示例："payload":{"count":5} 乔装打扮-将一颗球伪装成黑八
block_hole 示例："payload":{"count":5} 封穴锁口-封禁一个洞口一回合
gift_increase_aimline 示例："payload":{"count":5} 眼光长远-延长瞄准线
gift_decrease_aimline 示例："payload":{"count":5} 目光短浅-缩短瞄准线
gift_enhance_cue_ball 示例："payload":{"count":5} 炽焰护体-恢复摩擦力一回合
gift_wind_force 示例："payload":{"count":5} 因风借势-施加风场一回合

3.怪物消消乐，游戏ID=1664525565526667266

cmd value cmd附加数据(payload) 说明
gift_cover_clouds 示例：{"count":1,"count_limit":20,"show_time":50}
count：数量，默认为1
count_limit: 数量上限，默认为20
show_time: 显示时间，默认为20秒		 飘云
gift_cover_big_chain 示例：{"show_time": 10}
show_time：显示时间，默认为10秒		 大锁链
gift_windy 示例：{"count":1}
count： 飘走云数量，默认为1		 刮风
gift_discover_big_chain 解锁
gift_exchange_boards 交换棋盘
gift_add_chains count：int32 数量
count_limit: in32 数量上限		 增加小锁链
gift_add_ice_blocks count：int32 数量
count_limit: in32 数量上限		 增加冰块
gift_eliminate_chains count：int32 数量 清锁
gift_eliminate_ice_blocks count：int32 数量 清冰
gift_clear_all_chains 一键清锁
gift_clear_all_ice_blocks 一键清冰
gift_annoying_monster count：int32 数量
count_limit: in32 数量上限		 迷惑怪兽
gift_send_rockets count：int32 数量
count_limit: in32 数量上限		 送火箭
gift_send_bombs count：int32 数量
count_limit: in32 数量上限		 送炸弹
gift_send_rainbows count：int32 数量
count_limit: in32 数量上限		 送彩虹

4.对战消消乐 游戏ID=1689904909564116994

事件 value cmd附加数据(payload) 说明
gift_restore_health 示例：{"restore_health": 5}
restore_health：恢复生命值，默认为5点		 恢复生命
gift_increase_atk 示例：{"increase_atk": 1, "atk_bonus_duration": 1}
increase_atk：增加攻击力，默认为1点
atk_bonus_duration：持续回合数，默认为1		 增加攻击力
gift_increase_shield 示例：{"increase_shield": 1, "shield_duration": 1}
increase_shield：增加护盾减伤，默认为1点
shield_duration：持续回合数，默认为1		 增加护盾
gift_extra_turn 示例：{"extra_turn": 1, "count_limit": 1}
extra_turn：增加的回合数，默认为1
count_limit：存储额外回合上限，默认为1		 增加回合
gift_respawn 示例：{"count": 1, "count_limit": 1}
count：数量，默认为1
count_limit：上限，默认为1		 复活
gift_battle_rainbows 示例：{"count": 1}
count：数量，默认为1		 战斗彩虹

5.暴富矿工 游戏ID=1947922061064572929

事件 value cmd附加数据(payload) 说明
gift_cheer_up 示例：{"count":1}
count:礼物数量，叠加气泡时间和大小		 加油-在玩家头顶/周围形成一个气泡头像（初始0.8倍）持续3秒
以玩家头像为中心，吸引其他气泡头像，无重力
叠加效果：
1.气泡大小：10个变为0.9倍，100个1倍，1000个1.2倍
2.时间延长
gift_nightmare 黑夜-可见视野缩小
黑暗处显示送礼物者头像（恶魔相框），持续30秒
叠加效果：
1.视野不断缩小（有最小值）
2.时间延长
gift_exorcism_hook 辟邪钩-钩子无视障碍物（直接穿过）
钩子上有送礼物者头像（天使相框），持续30秒
叠加效果：时间延长
gift_wild_swing 疯狂摇摆-钩子摆动速度x5
钩子上有送礼物者头像（恶魔相框），持续30秒
叠加效果：时间延长
gift_avert_danger 逢凶化吉-所有障碍物变为普通宝箱
普通宝箱上有送礼物者的头像（天使相框）
叠加效果：无法叠加
gift_riddler 谜语人-场上所有物品变为随机物品
随机物品上有送礼物者的头像（恶魔相框）
叠加效果：无法叠加
gift_good_luck 鸿运当头-场上所有物品变为高级宝箱
高级宝箱上有送礼物者的头像（天使相框）
叠加效果：无法叠加
gift_annihilator 毁灭者-场上所有物品变为障碍物
障碍物上有送礼者的头像（恶魔相框）
叠加效果：无法叠加

6.怪物消消乐/monster crush，游戏ID=1664525565526667266

事件 value cmd附加数据(payload) 说明
gift_cover_clouds 示例：{"count":1}
count：int32 数量
count_limit: in32 数量上限
show_time: int32 显示时间		 飘云
gift_cover_big_chain 示例：{"count":1}
count：int32 数量
show_time: int32 显示时间		 大锁链
gift_windy 示例：{"count":1}
count：int32 飘走云数量		 刮风
gift_discover_big_chain 解锁
gift_exchange_boards 交换棋盘
gift_add_chains 示例：{"count":1}
count：int32 数量
count_limit: in32 数量上限		 增加小锁链
gift_add_ice_blocks 示例：{"count":1}
count：int32 数量
count_limit: in32 数量上限		 增加冰块
gift_eliminate_chains 示例：{"count":1}
count：int32 数量		 清锁
gift_eliminate_ice_blocks 示例：{"count":1}
count：int32 数量		 清冰
gift_clear_all_chains 一键清锁
gift_clear_all_ice_blocks 一键清冰
gift_annoying_monster 示例：{"count":1}
count：int32 数量
count_limit: in32 数量上限		 迷惑怪兽
gift_send_rockets 示例：{"count":1}
count：int32 数量
count_limit: in32 数量上限		 送火箭
gift_send_bombs 示例：{"count":1}
count：int32 数量
count_limit: in32 数量上限		 送炸弹
gift_send_rainbows 示例：{"count":1}
count：int32 数量
count_limit: in32 数量上限		 送彩虹

请求示例

{
  "mg_id": "xxx",
  "room_id": "xxx",
  "orders": [
    {
      "out_order_id": "xxx",
      "cmd": "gift_cover_big_chain",
      "value": 1,
      "from_uid": "15493",
      "to_uid": "15444",
      "payload": {}
    },
    {
      "out_order_id": "xxx",
      "cmd": "gift_cover_big_chain",
      "value": 1,
      "from_uid": "15493",
      "to_uid": "15445",
      "payload": {}
    }
  ]
}

返回参数

  • BaseResp
参数名 必选 类型 说明
ret_code 是 int 响应码
ret_msg 是 string 响应信息
data 是 BatchCreateOrderResp 响应数据
  • BatchCreateOrderResp
参数名 必选 类型 说明
orders 是 OrderEntry[] 订单数据 数组
  • OrderEntry
参数名 必选 类型 说明
out_order_id 是 string 商户订单号id
order_id 是 string SUD 订单号id

返回示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "orders": [
      {
        "order_id": "xxx",
        "out_order_id": "xxx"
      },
      {
        "order_id": "xxx",
        "out_order_id": "xxx"
      }
    ]
  }
}

业务错误码

错误码 错误描述 解决方案
10002 参数错误 检查请求参数，修改后重新发起请求
70501 订单号已存在 修改商户自定义的订单号，保证唯一性，再重新发起请求

results matching ""

    No results matching ""