信息收集策略

业务场景

  1. 提供查询接口给CP，以便游戏内判断，要否展示活动页面入口
  2. 只有部分用户，可参与手机号登记活动

注意事项

  1. 活动标识actCode的值，请找游戏运营申请
  2. 目前只有一种策略，scenarioId传固定值1829099279040049152

流程图

接口地址

https://cp.gzxianc.com/open-api/v1/user/strategies/collection

接口说明

  1. 协议：HTTPS
  2. 方式：POST
  3. ContentType：application/json;charset=utf-8
  4. 请求报文：
字段类型必需参与签名说明
appIdlong是是SDK的appId
channelIdlong是是SDK的渠道id
openIdstring是是SDK用户唯一标识
serverIdstring是是游戏区服ID
serverNamestring是是游戏区服名称
roleIdstring是是游戏角色ID
roleNamestring是是游戏角色名称
actCodestring是是活动标识
scenarioIdstring是是策略场景id
deviceModelstring是是设备型号
timestamplong是是毫秒时间戳
signstring是否签名
  1. 响应报文：
字段类型必需说明
codeint是响应状态码
msgstring是响应描述
dataobject否结果数据

data结构体

字段类型必需说明
displayint是要否展示登记页面：0-否, 1-要
linkUrlstring是活动页链接, 自带参数

请求示例

{
	"appId": 7011958,
	"channelId": 1905,
	"openId": "12345678912345678912345",
    "serverId": "4012241",
    "serverName": "青云41区",
    "roleId": "2700033751",
    "roleName": "云卷云舒",
    "actCode": "test-hm",
	"scenarioId": "1829099279040049152",
	"deviceModel": "Huawei P40 Pro Plus",
	"timestamp": 1725370774476,
	"sign": "acc920cbece92b581354759321b7b8ae"
}

响应示例

{
	"code": 0,
	"msg": "Success",
	"data": {
		"display": 1,
		"linkUrl": "https://act.xxx.com/moblie-survey/?actCode=test-hm&info=824594bd......bcccbaff11"
	},
	"meta": {
		"tid": "c69f51bc"
	}
}

签名规则

  1. 参数名区分大小写，按 ASCII 码从小到大排序（字典序）
  2. 只有值为 null 和名为 sign 的键值对，才不参与签名
  3. 使用 URL 键值对的格式，拼接成待签名字符串，签名 key 在最后拼接
  4. 将生成的签名与入参 sign 值作校验，验签忽略大小写
String sign = md5(k1=v1&k2=v2&k3=v3...&key=appKey);

调试示例

import cn.hutool.crypto.SecureUtil;

import java.util.HashMap;
import java.util.Map;
import java.util.TreeMap;

public class SignExample {

    public static String getMd5Sign(Map<String, Object> params, String appKey) {
        TreeMap<String, Object> sortedParams = new TreeMap(params);
        StringBuilder builder = new StringBuilder(512);
        sortedParams.forEach((k, v) -> {
            if (v != null) {
                builder.append(k).append("=").append(v).append("&");
            }
        });
        builder.append("key=").append(appKey);
        return SecureUtil.md5(builder.toString());
    }

    public static void main(String[] args) {
        String appKey = "AaBbCcDdEeFfGgHh";
        Map<String, Object> reqMap = new HashMap<>();
        reqMap.put("appId", 7011958L);
        reqMap.put("channelId", 1905L);
        reqMap.put("openId", "12345678912345678912345");
        reqMap.put("serverId", "4012241");
        reqMap.put("serverName", "青云41区");
        reqMap.put("roleId", "2700033751");
        reqMap.put("roleName", "云卷云舒");
        reqMap.put("actCode", "test-hm");
        reqMap.put("scenarioId", "1829099279040049152");
        reqMap.put("deviceModel", "Huawei P40 Pro Plus");
        reqMap.put("timestamp", 1725370774476L);
        System.out.println(String.format("信息收集签名:%s", getMd5Sign(reqMap, appKey)));
    }
}

状态码

状态码说明
0Success
11000参数为空
11001无效的参数
11002记录不存在
11003操作失败
11004无效的签名