# KUUKI 平台

# 区服信息

# 接口说明

1. 查询游戏区服列表
2. openID 为登录下发的openID，传值为空时，查询游戏所有区服列表，传值不为空时，查询用户登录过gameID的所有区服

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "name": "区服1",
      "id": "1001",
      "openTime": "2022-05-14 00:00:00"
    },
    {
      "name": "区服2",
      "id": "1002",
      "openTime": "2022-05-14 00:00:00"
    }
  ]
}

# 返回参数

# 角色信息

# 接口说明

用于特殊渠道查询角色战力等信息，是否接入请询问我方

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  //200：成功，-101:验证失败，-102:没有数据，-103:其他错误
  "msg": "成功",
  "data": [
    {
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "roleLevel": 201,
      "power": 1341321,
      "onCard": 1341321,
      "flag": 1341321
    },
    ...
  ]
}

# 返回参数

# 签名规则

sign=MD5(gameKey={GameKey}&openId={openId}&serverIds={serverIds}&time={time})

# 限购礼包

# 接口说明

1. 查询角色可购买限购礼包ID列表（仅返回第三方上架的限购礼包即可）

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "message": "OK",
  "data": [
    {
      "productId": "礼包id",
      "desc": "游戏内礼包显示名称"
    },
    {
      "productId": "礼包id",
      "desc": "游戏内礼包显示名称"
    }
  ]
}

# 返回参数

# 签名规则

sign=Md5(userId+roleId+serverID+gameID+product_id+SecretKey)SecretKey 由KUUKIGAME提供

# 预下单

# 接口说明

1. 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 港台(10011|10012)

# 角色信息

# 接口说明

用于特殊渠道查询角色战力等信息，是否接入请询问我方

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": [
    {
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "roleLevel": 201,
      "power": 1341321,
      "onCard": 1341321,
      "flag": 1341321
    }
  ]
}

# 返回参数

# 签名规则

sign=MD5(gameKey={GameKey}&openId={openId}&serverIds={serverIds}&time={time})

# 限购礼包

# 接口说明

1. 查询角色可购买限购礼包ID列表（仅返回第三方上架的限购礼包即可）

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

 {
  "code": "1000",
  "list": [
    "xxx.xxx.xxA",
    "xxx.xxx.xxB",
    "xxx.xxx.xxC"
  ]
}

# 返回参数

# 签名规则

sign=Md5(userId+roleId+serverID+gameID+SecretKey)SecretKey 由KUUKIGAME提供

# 预下单

# 接口说明

1. 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 奖励发放

# 接口说明

给指定角色发放奖品、用于活动或者预注册等场景

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "1000",
  "message": "发送奖励成功"
}

# 返回参数

# 签名规则

• sign = md5(userId+roleId+serverID+gameID+serialNo+packageId+SecretKey).toUpperCase()
• SecretKey 由KUUKIGAME提供

# 港台(10016)

# 区服信息

# 接口说明

1. 查询游戏区服列表
2. openID 为登录下发的openID，传值为空时，查询游戏所有区服列表，传值不为空时，查询用户登录过gameID的所有区服

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "name": "区服1",
      "id": "1001",
      "openTime": "2022-05-14 00:00:00"
    },
    {
      "name": "区服2",
      "id": "1002",
      "openTime": "2022-05-14 00:00:00"
    }
  ]
}

# 返回参数

# 角色信息

# 接口说明

用于特殊渠道查询角色战力等信息，是否接入请询问我方

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": {
    "serverId": "1",
    "serverName": "s1.五湖四海",
    "roleId": "2121",
    "roleName": "长了胡须了",
    "roleLevel": 201,
    "power": 1341321,
    "onCard": 1341321,
    "flag": 1341321
  }
}

# 返回参数

# 签名规则

sign=MD5(gameKey={GameKey}&roleId={roleId}&time={time})

# 限购礼包

# 接口说明

1. 查询角色可购买限购礼包ID列表（仅返回第三方上架的限购礼包即可）

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "ResultCode": "0",
  "ResultDesc": "success",
  "Data": [
    {
      "id": "1",
      "amount": "4500",
      "name": "45元礼包",
      "desc": "300金币 + 10元宝",
      "currency": "USD"
    },
    {
      "id": "2",
      "amount": "4500",
      "name": "45元礼包",
      "desc": "300金币 + 10元宝",
      "currency": "USD"
    }
  ]
}

# 返回参数

# 签名规则

• sign = md5(userId+roleId+gameID+SecretKey)
• SecretKey 由KUUKIGAME提供

# 预下单

# 接口说明

1. 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 港台(10018)

# 区服信息

# 接口说明

1. 查询游戏区服列表
2. openID 为登录下发的openID，传值为空时，查询游戏所有区服列表，传值不为空时，查询用户登录过gameID的所有区服

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "name": "区服1",
      "id": "1001",
      "openTime": "2022-05-14 00:00:00"
    },
    {
      "name": "区服2",
      "id": "1002",
      "openTime": "2022-05-14 00:00:00"
    }
  ]
}

# 返回参数

# 角色信息

# 接口说明

用于特殊渠道查询角色战力等信息，是否接入请询问我方

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": [
    {
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "roleLevel": 201,
      "power": 1341321,
      "onCard": 1341321,
      "flag": 1341321
    }
  ]
}

# 返回参数

# 签名规则

• openId、roleId、roleName 三者至少传一个，值不为空时参与签名 \
• sign=MD5(gameKey={GameKey}&serverIds={serverIds}&openId={openId}&roleId={roleId}&roleName={roleName}&time={time}) \
• 例如接收到的参数为 {"gameid":123456,"serverIds":"1","openId":"2","roleId":"3,"time":"4","sign":"xxx"} \
• sign=MD5(gameKey={GameKey}&serverIds=1&openId=2&roleId=3&time=4) \

# 已激活首充的商品查询

# 接口说明

1. 此接口主要是提供我方查询已激活首充（包含游戏内所有首冲翻倍）的商品。若游戏内重置了首冲，此接口返回内容也应同步更新

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "1000",
  "message": "成功",
  "data": {
    "double": [
      "xxx.xxx.xxA",
      "xxx.xxx.xxB",
      "xxx.xxx.xxC"
    ]
  }
}

# 返回参数

# 签名规则

sign=Md5(userId+roleId+serverID+gameID+SecretKey)SecretKey 由KUUKIGAME提供

# 预下单

# 接口说明

1. 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 谷歌预注册发奖接口

# 接口说明

1. 遊戲調用SDK選服創角介面後，我方SDK自動查詢預註冊商品並驗證，驗證通過後SDK伺服器通知遊戲伺服器，遊戲伺服器給玩家發獎勵。
2. 玩家通過谷歌商店進行預注冊->預注冊成功安裝sdk並且成功創角->我方服務端判斷發獎條件->調用貴方服務端接口
3. 約束：一個用戶標識ID 只能兌換一次。
4. 建議原廠那邊加一個判斷，一個 openid 只能兌換一次

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "1",
  "message": "OK",
  "data": "OK"
}

# 返回参数

# 签名规则

Md5(SecretKey+openid+order_id+gameID+serverID+timestamp)SecretKey 由KUUKIGAME提供

# 线下发放奖励

# 接口说明

1. 用于线下给玩家发放道具

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "1000",
  "message": "发送奖励成功"
}

# 返回参数

# 签名规则

• sign = md5(userId+roleId+serverID+gameID+serialNo+packageId+SecretKey).toUpperCase()
• SecretKey 由KUUKIGAME提供

# 越南(10020)

# 区服信息

# 接口说明

1. 查询游戏区服列表

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "message": "OK",
  "data": [
    {
      "server_name": "区服1",
      "server_id": "1001",
      "open_server_time": 1675067854,
      "type": 2
    },
    {
      "server_name": "区服2",
      "server_id": "1002",
      "open_server_time": 1675067854,
      "type": 1
    },
    {
      "server_name": "区服3",
      "server_id": "1003",
      "open_server_time": 1675067854,
      "type": 0
    }
  ]
}

# 返回参数

# 角色信息

# 接口说明

用于特殊渠道查询角色战力等信息，是否接入请询问我方

• 不传server_id或空，传openid， 返回当前uid在不同服的所有角色
• 传server_id, 传openid， 返回当前服的当前用户的所有角色

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "message": "OK",
  "data": [
    {
      "openid": "1008611",
      "server_id": "1",
      "server_name": "s1.五湖四海",
      "role_id": "2121",
      "role_name": "长了胡须了",
      "role_level": 201,
      "remain_coin": 1341321
    }
  ]
}

# 返回参数

# 签名规则

sign=MD5(gameKey={GameKey}&openId={openId}&time={time})

# 游戏用户封禁、解封

# 接口说明

1. 用户踢下线

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "0",
  "message": "OK"
}

# 返回参数

# 签名规则

• 第一步：将除 sign 以外的其他 值非空 的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param
• 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey
• 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 游戏用户扣除游戏货币

# 接口说明

1. 主要针对内购退款成功后，扣除游戏玩家游戏币

• A研发只支持扣到0
  例子：
  请求扣除deduct 1000 响应扣除之前before 500 响应成功扣除success 500
  请求扣除deduct 1000 响应扣除之前before 0 响应成功扣除success 0
  请求扣除deduct 1000 响应扣除之前before 2000 响应成功扣除success 1000

• B研发支持扣到负数
  例子：
  请求扣除deduct 1000 响应扣除之前before 500 响应成功扣除success 1000
  请求扣除deduct 1000 响应扣除之前before 0 响应成功扣除success 1000
  请求扣除deduct 1000 响应扣除之前before 2000 响应成功扣除success 1000
  请求扣除deduct 1000 响应扣除之前before -100 响应成功扣除success 1000

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "0",
  "message": "OK",
  "data": {
    "before_coin": "1008611",
    "success_deduct_coin": "1"
  }
}

# 返回参数

# 签名规则

• 第一步：将除 sign 以外的其他 值非空 的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param
• 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey
• 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 问卷调查完成通知

# 接口说明

技术需要根据 survey_id 去发放对应奖励，具体奖励内容由双方运营商议决定

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "0",
  "message": "OK"
}

# 返回参数

# 签名规则

• 第一步：将除 sign 以外的其他 值非空 的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param
• 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey
• 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 预下单

# 接口说明

1. 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

• 第一步：将除 sign 以外的其他 值非空 的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param
• 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey
• 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 全球(10021)

# 区服信息

# 接口说明

1. 查询游戏区服列表

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "name": "区服1",
      "id": "1001",
      "openTime": "2022-05-14 00:00:00",
      "is_history": 1
    },
    {
      "name": "区服2",
      "id": "1002",
      "openTime": "2022-05-14 00:00:00",
      "is_history": 0
    }
  ]
}

# 返回参数

# 角色信息

# 接口说明

1. 查询游戏角色信息

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "openid": "1008611",
      "server_id": "1",
      "server_name": "s1.五湖四海",
      "role_id": "2121",
      "role_name": "长了胡须了",
      "role_level": 201
    }
  ]
}

# 返回参数

# 签名规则

sign = MD5(server_id+role_id+time+GameKey)

# 预下单

# 接口说明

1. 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 韩国(10023)

# 下单

# 接口说明

• 游戏内跳转支付地址使用
• 此接口由我方提供

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# sign 生成规则

sign=MD5(channelid={channelid}&count={count}&cptradecode={cptradecode}&extstr={extstr}&gameid={gameid}&openid={openid}&packetid={packetid}&paybill={paybill}&roleid={roleid}&serverid={serverid}&signver={signver}&ts={ts}&userip={userip}&warename={warename}&{secretKey})

# 返回内容

{
  "code": 200,
  "msg": "",
  "data": {
    "redirectUrl": "https://xxx"
  }
}

# 返回参数

# 自动返利

# 接口说明

• 返利是针对角色返利
• 返利是针对订单号进行实时返利
• 返利多少元宝，我们已经计算好，研发这边直接用gold来返利游戏虚拟币，研发需要校验签名和rebate_no是否重复，gold是否为不正确数值0或负数
• 成功返利和已经返利code返回200，200表示已返利。判断订单号是否已经返利
• 此接口由研发提供

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# sign 生成规则

sign=MD5(gameid={gameid}&gold={gold}&openid={openid}&orderid={orderid}&paymoney={paymoney}&rebateid={rebateid}&rebatetype={rebatetype}&roleid={roleid}&serverid={serverid}&time={time}&key={gamekey})

# 返回内容

{
  "code": 200,
  "msg": "",
  "data": {}
}

# 返回参数

# 道具接口

# 接口说明

• 自动发放道具
• 此接口由研发提供

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# sign 生成规则

sign=MD5(content={mail.content}&gameid={gameid}&openid={openid}&orderid={orderid}&roleid={roleid}&serverid={serverid}&time={time}&title={mail.title}&key={gamekey})

# 返回内容

{
  "code": 200,
  "msg": "",
  "data": {}
}

# 返回参数

# 英文(10028)

# 区服信息

# 接口说明

• 查询游戏区服列表

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "name": "区服1",
      "id": "1001",
      "openTime": "2022-05-14 00:00:00",
      "type": 1
    },
    {
      "name": "区服2",
      "id": "1002",
      "openTime": "2022-05-14 00:00:00",
      "type": 0
    }
  ]
}

# 返回参数

# 角色信息

# 接口说明

• 不传serverIds或空，传openId，返回当前uid在不同服的所有角色
• 传serverIds，传openId，返回当前服的当前用户的所有角色
• 传serverIds，传openId，传roleId，返回当前服的当前用户的当前角色

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "openId": "1008611",
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "createTime": "2022-05-14 00:00:00",
      "roleLevel": 201,
      "totalAmount": 600
    }
  ]
}

# 返回参数

# 签名规则

sign=MD5(gameKey={GameKey}&openId={openId}&time={time})

# 预下单

# 接口说明

• 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 发放奖励

# 接口说明

• 技术需要根据 surveyId 去发放对应奖励，具体奖励内容由双方运营商议决定

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 越南(10032)

# 角色信息

# 接口说明

• 不传serverIds或空，传openId，返回当前uid在不同服的所有角色
• 传serverIds，传openId，返回当前服的当前用户的所有角色
• 传serverIds，传openId，传roleId，返回当前服的当前用户的当前角色

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK",
  "data": [
    {
      "openId": "1008611",
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "createTime": "2022-05-14 00:00:00",
      "roleLevel": 201,
      "totalAmount": 600
    }
  ]
}

# 返回参数

# 签名规则

sign=MD5(gameKey={GameKey}&openId={openId}&time={time})

# 发放奖励

# 接口说明

• 技术需要根据 surveyId 去发放对应奖励，具体奖励内容由双方运营商议决定

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": "200",
  "msg": "OK"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 预下单

# 接口说明

• 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": "cp_ordernumxxxxx"
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 言论接口

# 接口目的

该接口提供给游戏方将游戏内内容，包括但不限于（玩家发言 角色名 公会名 公会公告） 等内容，发往KUUKIGAME进行内容安全性过滤及验证。

# 接口

# 请求格式及方式

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "服务正常",
  "data": {
    "status": 1
  }
}

# 返回参数

# 港台(10064)

# 角色信息

# 接口说明

• 不传serverIds或空，传openId，返回当前传openId在不同服的所有角色
• 传serverIds，传openId，返回当前服的当前用户的所有角色
• 传serverIds，传openId，传roleId，返回当前服的当前用户的当前角色

# 接口

# 请求格式及方式

# 请求参数

# 签名规则

sign 加密方式

1. 剔除掉 sign 跟不需要签名的参数后，将参数数组按 key 升序排列，以 key=value 的方式用连接符"&"拼接成字符串 `param`
2. 将第一步的 `param` 拼接上我方提供的 &key={GameKey},示例：`preSign` = param+"&key={GameKey}"
3. 对第二步的 `preSign` 进行 md5 加密,示例：sign = md5(preSign)

# 返回内容

{
  "code": 200,
  "msg": "服务正常",
  "data": [
    {
      "openId": "1008611",
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "createTime": "2022-05-14 00:00:00",
      "roleLevel": 201,
      "leftAmount": 0,
      "totalAmount": 1
    }
  ]
}

# 返回参数

# 预下单

# 接口说明

• 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": {
    "gameOrderCode": "",
    "gameOrderCustomInfo": ""
  }
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 越南(10065)

# 角色信息

# 接口说明

• 不传serverIds或空，传openId，返回当前传openId在不同服的所有角色
• 传serverIds，传openId，返回当前服的当前用户的所有角色
• 传serverIds，传openId，传roleId，返回当前服的当前用户的当前角色

# 接口

# 请求格式及方式

# 请求参数

# 签名规则

sign 加密方式

1. 剔除掉 sign 跟不需要签名的参数后，将参数数组按 key 升序排列，以 key=value 的方式用连接符"&"拼接成字符串 `param`
2. 将第一步的 `param` 拼接上我方提供的 &key={GameKey},示例：`preSign` = param+"&key={GameKey}"
3. 对第二步的 `preSign` 进行 md5 加密,示例：sign = md5(preSign)

# 返回内容

{
  "code": 200,
  "msg": "服务正常",
  "data": [
    {
      "openId": "1008611",
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "createTime": "2022-05-14 00:00:00"
    }
  ]
}

# 返回参数

# 预下单

# 接口说明

• 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": {
    "gameOrderCode": "",
    "gameOrderCustomInfo": ""
  }
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 榜单信息

# 接口说明

• 分页相关的参数暂时可以忽略, 目前需求只需返回前50条

# 接口

# 请求格式及方式

# 请求参数

# 签名规则

sign 加密方式

1. 剔除掉 sign 跟不需要签名的参数后，将参数数组按 key 升序排列，以 key=value 的方式用连接符"&"拼接成字符串 `param`
2. 将第一步的 `param` 拼接上我方提供的 &key={GameKey},示例：`preSign` = param+"&key={GameKey}"
3. 对第二步的 `preSign` 进行 md5 加密,示例：sign = md5(preSign)

# 返回内容

{
  "code": 200,
  "msg": "服务正常",
  "data": {
    "pageNum": 1,
    "pageSize": 50,
    "total": 15,
    "rank": [
      {
        "openId": "1008611",
        "serverId": "1",
        "serverName": "s1.五湖四海",
        "roleId": "2121",
        "roleName": "长了胡须了"
      }
    ]
  }
}

# 返回参数

# 1-战力榜单

# 2-等级榜单

# 3-Ruby(道具)榜单

# 区服信息

# 接口说明

• 查询游戏区服列表

# 接口

# 请求格式及方式

# 请求参数

# 签名规则

sign 加密方式

1. 剔除掉 sign 跟不需要签名的参数后，将参数数组按 key 升序排列，以 key=value 的方式用连接符"&"拼接成字符串 `param`
2. 将第一步的 `param` 拼接上我方提供的 &key={GameKey},示例：`preSign` = param+"&key={GameKey}"
3. 对第二步的 `preSign` 进行 md5 加密,示例：sign = md5(preSign)

# 返回内容

{
  "code": 200,
  "msg": "服务正常",
  "data": {
    "serverList": [
      {
        "serverId": "1",
        "serverName": "s1.五湖四海"
      }
    ],
    "totalPage": 1
  }
}

# 返回参数

# 巴西(10069)

# 角色信息

# 接口说明

• 不传serverIds或空，传openId，返回当前传openId在不同服的所有角色
• 传serverIds，传openId，返回当前服的当前用户的所有角色
• 传serverIds，传openId，传roleId，返回当前服的当前用户的当前角色

# 接口

# 请求格式及方式

# 请求参数

# 签名规则

sign 加密方式

1. 剔除掉 sign 跟不需要签名的参数后，将参数数组按 key 升序排列，以 key=value 的方式用连接符"&"拼接成字符串 `param`
2. 将第一步的 `param` 拼接上我方提供的 &key={GameKey},示例：`preSign` = param+"&key={GameKey}"
3. 对第二步的 `preSign` 进行 md5 加密,示例：sign = md5(preSign)

# 返回内容

{
  "code": 200,
  "msg": "服务正常",
  "data": [
    {
      "openId": "1008611",
      "serverId": "1",
      "serverName": "s1.五湖四海",
      "roleId": "2121",
      "roleName": "长了胡须了",
      "createTime": "2022-05-14 00:00:00"
    }
  ]
}

# 返回参数

# 预下单

# 接口说明

• 研发方提供的第三方支付预下单接口

# 请求方式

POST url
header Content-Type:application/json

# 请求参数

# 返回内容

{
  "code": 200,
  "msg": "成功",
  "data": {
    "gameOrderCode": ""
  }
}

# 返回参数

# 签名规则

- 第一步：将除 sign 以外的参数按照字母顺序排序，以 key=value 的方式用连接符“&”拼接成字符串param

- 第二步：将第一步的 param 拼接上我方提供的 SecretKey,示例：preSign = param+SecretKey

- 第三步：对第二步的 preSign 进行 md5 加密,示例：sign = md5(preSign)

# 发放奖励

# 接口目的

该接口由研发提供，需要根据 giftId 去发放对应奖励，奖励内容由双方运营商议决定。

# 接口

# 请求格式及方式

# 请求参数

# sign 生成规则

sign 加密方式

1. 剔除掉 sign 跟不需要签名的参数后，将参数数组按 key 升序排列，以 key=value 的方式用连接符"&"拼接成字符串 `param`
2. 将第一步的 `param` 拼接上我方提供的 &key={GameKey},示例：`preSign` = param+"&key={GameKey}"
3. 对第二步的 `preSign` 进行 md5 加密,示例：sign = md5(preSign)

# 返回内容

{
  "code": 200,
  "msg": "服务正常"
}

# 返回参数