#

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 数量上限		 送彩虹

请求示例

{
  "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 ""