接口规范

接口说明

此接口为发行服务端调用游戏服务端的功能接口,接口地址由CP方提供,带*号标记的为必接选项。

接口格式

请求

  • 接口地址:CP提供
  • 请求方式:HTTP POST
  • Content-Type: application/json:charset=utf-8
  • X-Channel-ID: 渠道Id
  • 数据格式:JSON
参数类型描述
actionString接口标识
tslongUnix时间戳
data(可选)String请求参数JSON文本
signString签名

响应

  • Content-Type: application/json:charset=utf-8
  • 消息体:JSON
  • 状态码:1000 成功,参考状态码说明
参数类型描述
codeint1000 成功,参考状态码说明
msgString提示信息
data(可选)JSON响应数据JSON

签名算法

  • 签名规则:请求参数action+ts+data(data为空则不参于签名)+KEY得到签名原文(+为拼接字符),然后通过MD5加密得到密文
  • MD5(action+ts+data+KEY)
  • KEY:我方提供
  • 代码示例1:
// 请求data为空
String action = "serverList";
long ts = 1234567890;
String key = "382fd7198ac14359970789774d3fff29";
String plaintext = action + ts + key;
String sign = DigestUtils.md5Hex(plaintext);
System.out.println(sign);// 66f2a908c6ddd097a3802e47f61e4df0
  • 代码示例2:
// 请求data不为空
String action = "serverList";
long ts = 1234567890;
String key = "382fd7198ac14359970789774d3fff29";
JSONObject json = new JSONObject();
json.put("channelId", 1001);
String data = JSON.toJSONString(json);
String plaintext = action + ts + data + key;
String sign = DigestUtils.md5Hex(plaintext);
System.out.println(sign);// 49aaa50cfb708374d50c38dd21700061
Last Updated:
Contributors: 谢梁