文档中心 登录/注册 SDK下载 个推学堂

当前位置：个推文档 > 客户端 > 卓信ID > 服务端接口

1. 概述

卓信服务为CP提供卓信ID校验、群对群更新转换等服务，用于实现跨CP的数据应用。

2. 服务端API参考

接口域名： zxid-api.mobileservice.cn（生产环境）、sandbox-zxid-api.mobileservice.cn（沙盒环境）
接口协议： HTTPS、JSON
接口列表：

  • /data/ConvertZIDGroup 群对群转换
  • /verify/VerifyZIDs 验证 ZID 接口
  • /data/getSaid 获取 SAID
  • /data/convertAIDGroup 群对群转换 AID
  • /data/getLastActiveTime 活跃验证
  • /data/verifyAppPkg 应用验证
  • /data/getZIDTag 获取 ZID 标签
  • /data/getOaidQuantity 获取 OAID 历史关联数量
  • /data/verifyOaidModel OAID 机型匹配验证
  • /data/getOaidAppAT OAID 活跃验证
  • /data/verifyOaidApp OAID 应用验证
  • /data/getOaidZIDGroup OAID 群对群转换 ZID
  • /data/verifyOaidZID OAID ZID 一致性验证
  • /data/verifyZIDAID ZID AID 一致性验证
  • /data/getIdfaZIDGroup IDFA 群对群转换 ZID
  • /data/getZIDIdfaGroup ZID 群对群转换 IDFA
  • /data/convertSaidGroup SAID 群对群转换

公共请求参数：

参数名 类型 说明
Access-Key-Id string 通过管理后台申请分配的密钥标识。 该参数必须先向卓信官方申请才能使用，申请流程见“使用指南 -> 申请流程”
Partner-Id string 当前用户的 PartnerId 。 该参数必须先向卓信官方申请才能使用，申请流程见“使用指南 -> 申请流程”
Signature string 信息签名字符串，参考签名方式。
Signature-Method string 信息签名方法，目前固定为 HMAC-SHA256 。
Signature-Nonce string 64 字节以内的随机串，用于防止重放攻击，每次请求必须提供不同的值。
Timestamp string UTC时间戳，从UTC1970年1月1日0时0分0秒起至现在的总秒数。如 1632634877。
注：公共请求参数放置于 HTTP Request Header 请求头中，参数名与值大小写敏感。

签名方式：

  1. 使用请求参数构造标准请求字符串（Standard Query String），包括文档中的“公共请求参数”，但不包括“公共请求参数”中的 Signature 参数。将标准请求字符串进行排序，此排序是大小写敏感的，请使用标准文档中的大小写格式。
    具体排序示例： Access-Key-Id, Partner-Id, Signature-Method, Signature-Nonce, Timestamp 。
    将参数值使用英文等号 & 进行连接，即得到标准请求字符串。
    示例：accesskeyid&partnerid&HMAC-SHA256&67a4ac92-c53e-440d-b777-2b14f7a61a5c&1632634877

  2. 按照 RFC2104 对上面的 StringToSign 字符串计算签名 HMAC 值。计算签名时使用的 Key 就是用户持有的 AccessKeySecret ( 该参数必须先向卓信官方申请才能使用，申请流程见“使用指南 -> 申请流程”），使用的哈希算法为 SHA256 。

  3. 按照标准 Base64 编码规则，把上面的 HMAC 值编码为字符串，得到签名值（Signature）。
  4. 将得到的签名值作为 Signature 请求头的值，即完成请求签名的过程。

注意事项：
时间戳 Timestamp 不能偏差过多，目前允许误差为 5 分钟。

2.1 ConvertZIDGroup : 群对群转换

群对群更新转换为各 CP 方提供了一种批量地将失效卓信 ID 转换为最新卓信 ID 的方法，目前限定单次转换的卓信ID数量不少于 1000 个、不大于 10w 个（建议先在沙盒环境测试，沙盒环境限制为单次转换的卓信ID数量不少于 2 个、不大于 10w 个，沙盒环境与正式环境数据不互通）。服务端接受请求后会对收到的卓信 ID 进行合法性和是否过期进行检查，要求 99% 以上的 ID 应当为合法且过期的（考虑合作方服务器时间不同步，存在合作方判断过期，实际未过期的小概率可能性），才会认为此次请求有效。

最大响应时间：1w ZID 条件下 2s 内返回、10w ZID 条件下 10s 内返回。

接口名 ConvertZIDGroup
路径 /data/ConvertZIDGroup
请求参数 zids List<String> 待查询 ZID 群数组，数量范围：[1000, 10w]
返回参数 zids

jointDebugRemaining 		List<String>

int 		查询后最新的 ZID 群数组，按过期时间排序。

当该请求为正式环境联调模式请求时，将返回该值，表明用户还剩余多少次联调请求限额。

请求 / Request :

{
    "zids": [
        "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
        "Z01-1632005937-YUZvMQAM0O6M7zYx-CCA4",
        "Z01-1632047870-YUcS/gCxlxlLbzSB-B6BF",
        "Z01-1631983641-YUYYGQBcsunUsZvX-E1FB",
        "Z01-1631981930-YUYRagDuJV072tyx-E81D",
        "Z01-1632037734-YUbrZgAd3bZUfNmE-A1EC",
        "Z01-1631984838-YUYcxgArlLU3XB+6-F244",
        "Z01-1631989788-YUYwHAC6CkUtLDMj-34C5",
        "Z01-1632031977-YUbU6QDfWMMrI7+8-1EC2",
        // ...
    ]
}

返回 / Response :

{
    "zids": [
        "Z01-1642462621-YcLkjaIiuala89Az-J1ck",
        "Z01-1642421712-YcKJawklLa81jU-a-Pqkz",
        "Z01-1642169267-YcKjas71jNquaICP-2c1M",
        // ...
    ],
    "jointDebugRemaining": 1000
    // 当该请求为正式环境联调模式请求时，将返回该值，表明用户还剩余多少次联调请求限额。
}

注：

  1. POST 请求，请求参数使用 JSON 编码。
  2. 接口请求参数与值均为大小写敏感。
  3. 请求中待查询的有效 ZID 数组大小严格要求在范围内，不能过多或过少。
  4. 99% 以上的 ZID 应当是合法且过期的，在满足上述条件的情况下，未过期 ZID 在 Response 中原封不动返回。
  5. 在正式环境联调模式下，请求 ZID 数量最少 10 个，详细规则参考 正式环境联调模式。

正式环境联调模式

考虑到有初期接入客户一开始正式环境的 ZID 不足 1000 个，无法通过常规手段调用群对群翻译接口。
为了保障初期接入，我们为客户开设一个短期的白名单：

  • 为期 7 天的正式环境联调模式
  • 为每个客户提供包含 100 个过期 ZID 包作为联调权益包，用于正式环境联调模式
  • 对于包含包内 ZID 的请求，降低查询 ID 数下限值 （10个）
  • 计次：针对特权包请求，只能调用有限次数（目前每个服务商 1000 次）

2.2 VerifyZIDs : 验证 ZID 接口

验证 ZID 接口接受一组 ZID 输入（输入数量 ≤ 10w ），按原顺序返回传入的 ZID 的验证结果。

接口名 VerifyZIDs
路径 /verify/VerifyZIDs
请求参数 zids List<String> 待验证 ZID 数组，大小范围：≤ 10w
返回参数 realZIDs

fakeZIDs 		List<String>

List<String> 		验证通过的 ZID 数组

验证未通过的 ZID 数组

请求 / Request :

{
    "zids": [
        "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
        "Z01-1632005937-YUZvMQAM0O6M7zYx-CCA4",
        "Z01-1632047870-YUcS/gCxlxl12345-1234",
        "abcd1234",
        "",
        " ",
        "abcd1234",
        // ...
    ]
}

返回 / Response :

{
    "realZIDs": [
        "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
        "Z01-1632005937-YUZvMQAM0O6M7zYx-CCA4",
        // ...
    ],
    "fakeZIDs": [
        "Z01-1632047870-YUcS/gCxlxl12345-1234",
        "abcd1234",
        "",
        " ",
        "abcd1234",
        // ...
    ]
}

2.3 GetSaid : 获取 SAID

通过 SDK 预取号得到的授权码获取 SAID

接口名 GetSaid
路径 /data/getSaid
请求参数 authToken String 通过 ZXSDK 预取号接口 getAuthToken 获取
返回参数 said String 加密后的said

请求 / Request :

{
    "authToken": "mWHbIYBY51+bC4SxHJxrycVevjL5QgGFwB00AADgn5QuX2aNVPmSQYwTNYwV8sHkEYu83oN9jWJrWyrez5bc0Xnwd1vfnrhWtlCsEB9aPHUsldwOGWfo2oUUQ0AJ6Ccvk9Ie261Cv71SPnJA2TcmG8Csi/AQLHcdvqi8ZGldHlUqUv3K6IxuN+tHMwNHgp8ERFLI+sfXFo21wVEsuHDStI8Z3/R+RrOxD1ZaUJUsy9Racq9EViwwhqKQKAIqGrto/7X26pLEfARgucwpgSe2JA=="
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "said": "13rIDDQSTSatIMWpWFGnYEth7xgYyCAfSvc/hwgUNL4SG2drDLTipR0GZKOfZl/mOylMsuLbkz5Ntp8XR/Ixjz9mevN1VbhB8k+6cbQbvyHGuyCZ/LAMuwjGonQto6ilHRULJaRqvc4+r7tsEFcr38lCAeGC4tHf4Np0C61aRQYzTO/elU0q3g35nWr+0DQN7o4pR5egJ7ag2B+oZ4CC2g=="
    }
}

注：
拿到加密后的 said 需要经过服务端解密 (AES/CBC/PKCS7Padding)，用于解密的 SAID token 可在 ”卓信官网-开发者信息页-应用管理“ 获取，解密方法参考资料包中示例代码 aesCBCPkcs7Padding.go 或者 SAIDDecrypt.java 。

2.4 ConvertAIDGroup : 群对群转换AID

批量将卓信 ID 转换为请求方的 VAID ，目前限定单次转换的卓信 ID 数量不少于 1000 个、不大于 10w 个。

接口名 ConvertAIDGroup
路径 /data/convertAIDGroup
请求参数 zids List<String> 待转换的 zids 数组，大小范围：[1000, 10w]
返回参数 aids List<String> 转换后的的 aids 数组

请求 / Request :

{
    "zids": [
        "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
        "Z01-1632005937-YUZvMQAM0O6M7zYx-CCA4",
        "Z01-1632047870-YUcS/gCxlxl12345-1234",
        "abcd1234",
        "",
        " ",
        "abcd1234",
        // ...
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "aids": [
            "A01-6osXa0vcf6Zk7a9f8KC3JMgOQlxxxxxx",
            "A01-haR5GvUG9uQb9zrATDoTNBpTxBoXxxxx",
            "A01-tLQPG9YIES6yrnA6NpSR21bUd6xxxxxx",
            "A01-ZmzpTGhiMGdy65mTSO7iZlTe3RpBxxxx",
              "",
                " ",
              // ...
             ]
    }
}

2.5 GetLastActiveTime : 活跃验证

接口名 GetLastActiveTime
路径 /data/getLastActiveTime
请求参数 zids List<String> 待验证的 zids 数组，大小范围：zids ≤ 10w
appPkg String 待验证的应用包名
返回参数 appLATs Map<String><String> 请求的 zid 所对应的 appPkg 的活跃时间

请求 / Request :

{
      "appPkg":"com.test.dev",
    "zids": [
        "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
        "Z01-1632005937-YUZvMQAM0O6M7zYx-CCA4",
        "Z01-1632047870-YUcS/gCxlxl12345-1234",
        "abcd1234",
        "",
        " ",
        "abcd1234",
        // ...
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "appLATs": {
            "Z01-1648375246-zIN+YAAdDRvYvsaZ-FA7C": "1661244117000",
            "Z01-1654830846-1V3fAwDXWS+5yrIq-C680": "1661244117000",
            "Z01-1659639145-pK0dhADp8atYydr2-D683": "1661244117000"
        }
    }
}

2.6 VerifyAppPkg : 应用验证

接口名 VerifyAppPkg
路径 /data/verifyAppPkg
请求参数 zids List<String> 待验证的 zids 数组，大小范围：1 ≤ zids ≤ 10w
appPkg String 待验证的应用包名
返回参数 analysis Map<String><int> 请求 zid 所对应 appPkg 的安装情况，枚举：1未知 2安装 3卸载

请求 / Request :

{
      "appPkg":"com.test.dev",
    "zids": [
        "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
        "Z01-1632005937-YUZvMQAM0O6M7zYx-CCA4",
        "Z01-1632047870-YUcS/gCxlxl12345-1234",
        "abcd1234",
        "",
        " ",
        "abcd1234",
        // ...
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "analysis": {
            "Z01-1648375246-zIN+YAAdDRvYvsaZ-FA7C": 1,
            "Z01-1654830846-1V3fAwDXWS+5yrIq-C680": 2,
            "Z01-1659639145-pK0dhADp8atYydr2-D683": 3
        }
    }
}

2.7 GetZIDTag : 获取 ZID 标签

接口名 GetZIDTag
路径 /data/getZIDTag
请求参数 zids List<String> zids 数组，大小范围：1 ≤ zids ≤ 10w
appPkg String 应用包名
返回参数 list Array 列表
zid String zid
tags Array 标签列表
tagCode string 标签code
tagName string 标签名称
level string 标签等级

请求 / Request :

{
      "appPkg":"com.test.dev",
    "zids": [
        "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
        "Z01-1632005937-YUZvMQAM0O6M7zYx-CCA4",
        "Z01-1632047870-YUcS/gCxlxl12345-1234",
        "abcd1234",
        "",
        " ",
        "abcd1234",
        // ...
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "list": [
            {
                "zid": "Z01-1631983930-YUYZOgAWp64tVh1b-3662",
                "tags": [
                    {
                        "tagCode": "2",
                        "tagName": "疑似刷机",
                                                "level": "低风险"
                    },
                    {
                        "tagCode": "1",
                        "tagName": "疑似新增",
                        "level": "高风险"
                    }
                ]
            }
            ...
         ]
    }
}

2.8 GetOaidQuantity : 获取 OAID 历史关联数量

查询 OAID 对应设备关联的 OAID 总数，帮助开发者验证设备真实性。

接口名 GetOaidQuantity
路径 /data/getOaidQuantity
请求参数 oaids List<String> 待验证的 OAIDS 数组，大小范围：1 ≤ OAIDS ≤ 10w
type int oaid 类型 0:oaid 原值请求 1: oaid md5 加密请求
返回参数 oaids object OAID 对应设备关联的 OAID 总数

请求 / Request :

{
    "oaids": [
        "7d7bad43-49c9-4752-9bda-867311db95f4",
        "3d0b7c8b-963e-46bc-b8e5-7280e7185ded",
    ],
      "type": 0
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "oaids": {
            "7d7bad43-49c9-4752-9bda-867311db95f4": 10,
              "3d0b7c8b-963e-46bc-b8e5-7280e7185ded": 0
        }
    }
}

2.9 VerifyOaidModel : OAID 机型匹配验证

验证 OAID 与机型是否唯一匹配。

接口名 VerifyOaidModel
路径 /data/verifyOaidModel
请求参数 model String 待验证的机型
oaids List<String> 待验证的 OAIDS 数组，大小范围：1 ≤ OAIDS ≤ 10w
type int oaid 类型 0:oaid 原值请求 1: oaid md5 加密请求
返回参数 oaids object OAID 与机型的匹配结果
oaid:result，其中 result 枚举：1未知 2验证成功 3验证失败

请求 / Request :

{
    "model": "huawei",
    "oaids": [
        "7d7bad43-49c9-4752-9bda-867311db95f4",
        "3d0b7c8b-963e-46bc-b8e5-7280e7185ded",
    ],
      "type": 0
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "oaids": {
            "7d7bad43-49c9-4752-9bda-867311db95f4": 1,
              "3d0b7c8b-963e-46bc-b8e5-7280e7185ded": 2
        }
    }
}

2.10 GetOaidAppAT : OAID 活跃验证

验证 OAID 对应设备内指定应用的活跃情况。

接口名 GetOaidAppAT
路径 /data/getOaidAppAT
请求参数 appPkg String 待验证的包名
oaids List<String> 待验证的 OAIDS 数组，大小范围：1 ≤ OAIDS ≤ 10w
type int oaid 类型 0:oaid 原值请求 1: oaid md5 加密请求
返回参数 oaids object activeType 活跃类型枚举：1未知 2设备活跃 3APP活跃
activeTime 活跃时间

请求 / Request :

{
    "appPkg": "test",
    "oaids": [
        "923adf24-e010-4143-a41d-7e2dd75904d4",
        "422ce21f-5a31-49e9-9c20-6886720dd351",
        "21b3f714-657d-4294-af03-693ff51e627e"
    ],
      "type": 0
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
          "oaids": {
            "923adf24-e010-4143-a41d-7e2dd75904d4": {
                "activeType": 3,
                "activeTime": 1667267316000
            },
            "422ce21f-5a31-49e9-9c20-6886720dd351": {
                "activeType": 3,
                "activeTime": 1667267316000
            },
            "21b3f714-657d-4294-af03-693ff51e627e": {
                "activeType": 1,
                "activeTime": 0
            }
        }
    }
}

2.11 VerifyOaidApp : OAID 应用验证

验证 OAID 对应设备内指定应用的安装情况。

接口名 VerifyOaidApp
路径 /data/verifyOaidApp
请求参数 appPkg String 待验证的包名
oaids List<String> 待验证的 OAIDS 数组，大小范围：1 ≤ OAIDS ≤ 10w
type int oaid 类型 0:oaid 原值请求 1: oaid md5 加密请求
返回参数 oaids object oaid:result
result 枚举：1未知 2安装 3卸载

请求 / Request :

{
    "appPkg": "test",
    "oaids": [
        "923adf24-e010-4143-a41d-7e2dd75904d4",
        "422ce21f-5a31-49e9-9c20-6886720dd351",
        "21b3f714-657d-4294-af03-693ff51e627e"
    ],
      "type": 0
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
          "oaids": {
            "923adf24-e010-4143-a41d-7e2dd75904d4": 1,
            "422ce21f-5a31-49e9-9c20-6886720dd351": 2,
            "21b3f714-657d-4294-af03-693ff51e627e": 3
        }
    }
}

2.12 GetOaidZIDGroup : OAID 群对群转换 ZID

获取 OAID 对应最新的 ZID 列表

接口名 GetOaidZIDGroup
路径 /data/getOaidZIDGroup
请求参数 oaids List<String> 待验证的 OAIDS 数组，大小范围：1 ≤ OAIDS ≤ 10w
type int oaid 类型 0:oaid 原值请求 1: oaid md5 加密请求
返回参数 zids object oaid:zid

请求 / Request :

{
    "oaids": [
        "923adf24-e010-4143-a41d-7e2dd75904d4",
        "422ce21f-5a31-49e9-9c20-6886720dd351",
        "21b3f714-657d-4294-af03-693ff51e627e"
    ],
      "type": 0
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
          "zids": {
            "923adf24-e010-4143-a41d-7e2dd75904d4": "Z01-1668896538-4lgNYgDRBiHYdqAA-01CE",
            "422ce21f-5a31-49e9-9c20-6886720dd351": "Z01-1668896538-4lgNYgDRBiHYdqAC-01CE",
            "21b3f714-657d-4294-af03-693ff51e627e": "Z01-1668896538-4lgNYgDRBiHYdqAB-01CE"
        }
    }
}

2.13 VerifyOaidZID : OAID ZID 一致性验证

验证 OAID 与 ZID 是否匹配。

接口名 VerifyOaidZID
路径 /data/verifyOaidZID
请求参数 verify Array 待验证的 OAID 和 ZID 数组，大小范围：1 ≤ verify ≤ 10w
type int oaid 类型 0:oaid 原值请求 1: oaid md5 加密请求
返回参数 oaids object oaid:result
result 枚举：1未知 2验证成功 3验证失败

请求 / Request :

{
    "verify": [
        {
            "oaid": "923adf24-e010-4143-a41d-7e2dd75904d4",
            "zid": "Z01-1669896538-4lgNYgDRBiHYdqUf-01CE"
        },
        {
            "oaid": "422ce21f-5a31-49e9-9c20-6886720dd351",
            "zid": "Z01-1669896538-4lgNYgDRBiHYdqUf-01CE"
        },
        {
            "oaid": "21b3f714-657d-4294-af03-693ff51e627e", 
            "zid": "Z01-1669896538-4lgNYgDRBiHYdqUf-01CE"
        }
    ],
      "type": 0
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
          "oaids": {
            "923adf24-e010-4143-a41d-7e2dd75904d4": 1,
            "422ce21f-5a31-49e9-9c20-6886720dd351": 2,
            "21b3f714-657d-4294-af03-693ff51e627e": 3
        }
    }
}

2.14 VerifyZIDAID : ZID AID 一致性验证

验证 ZID 与 AID 是否匹配。

接口名 VerifyZIDAID
路径 /data/verifyZIDAID
请求参数 verify Array 待验证的 ZID 和 AID 数组，大小范围：1 ≤ verify ≤ 10w
返回参数 zid object zid:result
result 枚举：1验证成功 2验证失败

请求 / Request :

{
    "verify": [
        {
            "aid": "A01-Gqlyg8S9nzw1/MeA3i8/wP9i+ZUPfkVy",
            "zid": "Z01-1648243244-dbhYMABoSAnrfXIP-13AC"
        },
        {
            "aid": "A01-JLKwV5XLlClUdH8s7OKyWvYIHRIY3UA5",
            "zid": "Z01-1656578405-Kog7TQCu59iw6H0U-DB9F"
        }
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
          "zid": {
            "Z01-1648243244-dbhYMABoSAnrfXIP-13AC": 1,
            "Z01-1656578405-Kog7TQCu59iw6H0U-DB9F": 2
        }
    }
}

2.15 GetIdfaZIDGroup : IDFA 群对群转换 ZID

获取 IDFA 对应最新的 ZID 列表

接口名 GetIdfaZIDGroup
路径 /data/getIdfaZIDGroup
请求参数 idfas List<String> 需要转换的 idfa 数组，大小范围：1 ≤ idfas ≤ 10w
返回参数 zids object idfa 转换成功会返回对应的zid，转换失败会返回空值

请求 / Request :

{
    "idfas": [
        "382e921c-6866-47ed-91f2-d0bbaae4370a",
        "0852efd0-668a-48e1-a15c-a575cf1cb9cf",
        "7fbbedff-6329-48b6-b8e8-a58c13f2a395"
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
          "zids": {
            "7fbbedff-6329-48b6-b8e8-a58c13f2a395": "Z01-1648243244-dbhYMABoSAnrfXIP-13AC",
            "382e921c-6866-47ed-91f2-d0bbaae4370a": "Z01-1656578405-Kog7TQCu59iw6H0U-DB9F",
            "0852efd0-668a-48e1-a15c-a575cf1cb9cf": ""
        }
    }
}

2.16 GetZIDIdfaGroup : ZID 群对群转换 IDFA

获取 ZID 对应最新的 IDFA 列表

接口名 GetZIDIdfaGroup
路径 /data/getZIDIdfaGroup
请求参数 zids List<String> 需要转换的 zids 数组，大小范围：1 ≤ zids ≤ 10w
返回参数 idfas object zid 转换成功会返回对应的 idfa，转换失败会返回空值

请求 / Request :

{
    "zids": [
        "Z01-1648243244-dbhYMABoSAnrfXIP-13AC",
        "Z01-1656578405-Kog7TQCu59iw6H0U-DB9F",
        "Z01-1669896538-4lgNYgDRBiHYdqUf-01CE"
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
          "idfas": {
            "Z01-1648243244-dbhYMABoSAnrfXIP-13AC":"7fbbedff-6329-48b6-b8e8-a58c13f2a395",
            "Z01-1656578405-Kog7TQCu59iw6H0U-DB9F":"382e921c-6866-47ed-91f2-d0bbaae4370a",
            "Z01-1669896538-4lgNYgDRBiHYdqUf-01CE": ""
        }
    }
}

2.17 ConvertSaidGroup : SAID 群对群转换

SAID 群对群转换。

接口名 ConvertSaidGroup
路径 /data/convertSaidGroup
saids List<String> 需要转换的 said 数组，大小范围：1 ≤ saids ≤ 1w
返回参数 saids Array carrierType: 运营商类型 (0: 未知 1: 移动 2: 联通 3: 电信)
said: 转换成功对应的 said，转换失败会返回空字符串

请求 / Request :

{
    "saids" :[
        "1",
        "S01-VEjcfyGzbWU+8RelCDRL5HNIrIBJfqKNbtvM65Aln6S7dWNUq3u06Ef6Oy8Z2jzEY/FXnO+tyBlBXwYTv1DEAsKut+yDYorMsz2OWDPbLG8UjDr36gK3PPCQbycVfN9e",
        "S01-VsVJ+0CzEqZGiwtEazCBc9LfTTG9tVhGwUoKZDseHZYkPFPmDnhs9S9fxK0eezt6SUsUafq36WOES4zEX486NLdQigObjFr+oTAUd7H9kZOBjsP7N695JXgmTgijMeZl",
        "S01-cuKVAcLigMceanF3Hc33yGWsI7XQUzkoL6ca+e83KKm9a+K7nB5Ee/PPhkycMJ/WPjvsP7V/fVR8tkOJpx8tSBmE1HKSMLZi8msOtp02BsaVHYD5YsOLCzQXXxfWiFiK",
        "S01-zVvliE8n1P3Th1/bVCqpUf0H9NgRvlqMWydggu95F5qI32ZCmZN6q6x3bJMXZl7p9uLjiReLqEpjmv0otEhKqyHGhkjFqaIDHOW8MMbDfUGatSuE8rVRyGsmMYTHDwZt"
    ]
}

返回 / Response :

{
    "code": 200,
    "msg": "success",
    "data": {
        "saids": [
            {
                "carrierType": 0,
                "said": ""
            },
            {
                "carrierType": 1,
                "said": "91547438B38E41D7B2C56C2161DD6046AD4B8EEFE5C34E818CF84407B4D268CB"
            },
            {
                "carrierType": 2,
                "said": "7e597b025a8340488f835e729630e0e97124c9e4012d469e8d726b7b46023ddd"
            },
            {
                "carrierType": 3,
                "said": "5127bee50844420ca573f537c400eedd40fda6f70ce44cc9b4c49538779d7da6e324012089b64de48afc9800d4ad603a34463a5bc1ec43f2922bdbe434872e25"
            }
        ]
    }
}

3. 群对群转换

卓信ID群对群转换服务是为了便于各CP方维护基于卓信ID生成的用户群信息，支持数字营销、统计分析等应用场景而提供的失效卓信ID更新服务，该服务不可用于单个个体的卓信ID转换，各CP不得尝试通过变更单一ID来变相获取单一卓信ID的转换能力。卓信服务将通过定期巡检方式进行检查，对于违规CP，我们将停止提供相应的群对群转换服务。

在这篇文章中： 1. 概述 2. 服务端API参考 2.1 ConvertZIDGroup : 群对群转换 2.2 VerifyZIDs : 验证 ZID 接口 2.3 GetSaid : 获取 SAID 2.4 ConvertAIDGroup : 群对群转换AID 2.5 GetLastActiveTime : 活跃验证 2.6 VerifyAppPkg : 应用验证 2.7 GetZIDTag : 获取 ZID 标签 2.8 GetOaidQuantity : 获取 OAID 历史关联数量 2.9 VerifyOaidModel : OAID 机型匹配验证 2.10 GetOaidAppAT : OAID 活跃验证 2.11 VerifyOaidApp : OAID 应用验证 2.12 GetOaidZIDGroup : OAID 群对群转换 ZID 2.13 VerifyOaidZID : OAID ZID 一致性验证 2.14 VerifyZIDAID : ZID AID 一致性验证 2.15 GetIdfaZIDGroup : IDFA 群对群转换 ZID 2.16 GetZIDIdfaGroup : ZID 群对群转换 IDFA 2.17 ConvertSaidGroup : SAID 群对群转换 3. 群对群转换
开发者中心 SDK 下载

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询