用户重叠标识

业务场景

  1. 基于 appId 和 openId，查询用户在同一游戏多端有角色的用户信息，以便制定差异化的运营活动
  2. 多端，包括但不限：小游戏、端包、纯H5链接

注意事项

  1. 接口限流：当前 QPS 是 100/s

接口地址

https://cp.gzxianc.com/open-api/v1/user/tag-overlap-info

接口说明

  1. 协议：HTTPS
  2. 方式：POST
  3. ContentType：application/json;charset=utf-8
  4. 请求报文：
字段类型必需参与签名说明
appIdlong是是SDK的 appId
openIdstring是是SDK用户唯一标识
timestamplong是是毫秒时间戳
signstring是否签名
  1. 响应报文：
字段类型必需说明
codeint是状态码：0代表成功，非0代表失败
msgstring是响应描述
dataarray否结果数据

data结构体

字段类型必需说明
typeint是类型：1-端包，2-纯H5，3-抖音小游戏，4-微信小游戏，5-支付宝小游戏，6-美团小游戏，7-快手小游戏
userDataarray是用户数据

userData结构体

字段类型必需说明
openIdstring是SDK用户唯一标识
lastLoginTimestring是最后登录时间，格式：yyyy-MM-dd HH:mm:ss
totalAmountlong是累积充值金额，单位:分

请求示例

{
	"appId": 2017990,
	"openId": "1731737507115982483801423",
	"timestamp": 1741857239240,
	"sign": "31e6525890539db90698f4665ac81ea8"
}

响应示例

{
	"code": 0,
	"msg": "Success",
	"data": [{
		"type": 1,
		"userData": [{
			"openId": "1731203578301402768177558",
			"lastLoginTime": "2025-03-12 23:13:01",
			"totalAmount": 51200
		}, {
			"openId": "1731737507115982483801423",
			"lastLoginTime": "2025-03-01 01:54:44",
			"totalAmount": 0
		}]
	}, {
		"type": 2,
		"userData": [{
			"openId": "1731203578301402768177558",
			"lastLoginTime": "2025-02-14 22:17:46",
			"totalAmount": 1555600
		}, {
			"openId": "1734831284824782286858171",
			"lastLoginTime": "2024-12-25 06:40:56",
			"totalAmount": 23000
		}]
	}],
	"meta": {
		"tid": "01c2f4b5"
	}
}

签名规则

  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", 2017990L);
        reqMap.put("openId", "1731737507115982483801423");
        reqMap.put("timestamp", 1741857239240L);
        System.out.println(String.format("重叠标识签名:%s", getMd5Sign(reqMap, appKey)));
    }
}