# 获取隐私授权描述信息

# 接口说明

通过此方式开始调用腾讯游戏来联活动中的配置的隐私授权的相关权限节点，并获取返回信息。

# 先决条件

在腾讯游戏来联已立项。如何立项活动？
在隐私授权管理配置并发布

# 请求示例

curl "https://s1.livelink.qq.com/livelink/?
apiName=ApiGetPrivacyAuth&livePlatId=xx&actId=1201&gameId=cf&v=2.0&t=&nonce=&code=diVa28UpyL5G%2BVmKNVIcg%3D%3D&sig=e3909d0a2cb7f7d8f2ec03fb4ea96007" -d '{"gameAuthScene":"act_911"}'

1
2

# 公共参数(GET)

参数	类型	说明	是否必填
apiName	string	固定：ApiGetPrivacyAuth，不参与签名	是
livePlatId	string	平台id，腾讯游戏来联统一分配	是
actId	int	活动id，立项时的项目id	是
gameId	string	业务名称，见《业务代码》	是
v	float	固定：2.0	是
t	int	Unix时间戳，精度：秒	是
nonce	string	8位随机字符串	是
code	string	用户登录态。平台侧，可参考《平台侧接入》	是
sig	string	签名，见《加密与签名》	是

# 私有参数(json)

参数	类型	说明	是否必填
gameAuthScene	string	隐私授权的key,活动一般都是活动id拼接"act_",如act_2011,act_998	是

# 接口返回

# 当前911活动配置了隐私授权

{
  "apiName": "ApiGetPrivacyAuth",
  "iRet": 0,
  "jData": {
    "gameAuthScene": "act_911",
    // 隐私授权的key
    "name": "sw反绑",
    // 隐私授权名称
    "permissions": [
      {
        "name": "账号信息",
        "purpose": "拉取用户账号信息"
      }
    ]
  },
  "sMsg": "ok",
  "tid": "10df3d266188f406715948b3b8907901",
  "v": 2
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 当前911活动没有配置隐私授权

{
  "iRet": 0,
  "sMsg": "ok",
  "jData": {
    "gameAuthScene": "act_911",
    "name": "sw反绑",
    "permissions": []
  },
  "tid": "10df3d266188f406715948b3b8907901",
  "v": 2,
  "apiName": "ApiGetPrivacyAuth"
}

1
2
3
4
5
6
7
8
9
10
11
12
13

# 返回参数

参数	类型	说明
iRet	int	流程调用错误码。0为流程调用正常，非0为错误
sMsg	string	错误提示信息
tid	string	日志ID，建议保留
v	int	接口版本，当前为2
apiName	string	返回中apiName字段与请求中apiName含义不一样，此处为输出该数据的模块ID，此处最终处理模块ID为FlowConditionQuery
jData	object	jData输出结构

参数	类型	说明
jData.gameAuthScene	string	隐私授权的key
jData.name	string	隐私授权名称，一般是活动名称
jData.permissions	array	隐私授权具体节点
jData.permissions.name	string	权限节点名称
jData.permissions.purpose	string	权限节点具体用途

# 接口业务错误码说明

错误码	错误说明	处理建议
0	请求成功
-180001	隐私授权场景不存在	1.检查传入参数gameAuthScene是否正确 2.联系中台同学确认隐私授权场景是否发布

← 获取平台账号已绑定的游戏列表添加测试白名单 →