# 平台手机号用户信息接入

# 1. 背景

目前账号绑定存在需要在游戏内绑定平台账号的场景（反绑），这个场景的标准方案是让平台提供手机号信息相关的接口给到中台，由中台封装到 SDK 给到游戏接入。以下是对接口的协议和入参出参说明，平台按照说明实现接口给到中台。

# 2. 接口通用说明

# 接口域名

由平台侧提供，中台用来调用平台接口

# 通用参数说明

通用参数统一放在 querystirng 中

字段名称	字段类型	字段是否必填	字段说明
appId	string	是	平台侧向中台统一申请的英文id
t	int	是	当前时间戳
nonce	string	是	随机数，建议8位大小写英文字母+数字随机字符串
sign	string	是	将querystring中所有参数按键名称部分使用ASCII排序，将所有的值中间用"+"拼接起来，最后用"+"拼接中台分配的签名密钥，得到的数据md5后转小写字母例如：appId=livelink&t=1652098836&nonce=11223344 步骤一：str = "livelink+11223344+1652098836" 步骤二：str += “+xxxxxxx“ （xxxxxx为中台分配签名密钥步骤三：sign = strtolower(md5(str))

# 3. 发送短信验证码接口

# 使用说明

中台传给平台手机号，平台给用户手机号发送验证码短信

# 路由

/tencent/livelink/user/sendPhoneCode

# 方法

POST（application/json）

# 请求参数

{
  "phone": "13511112222", // 手机号，必填
  "userIp": "192.168.1.1", // 用户IP，必填
  "actId": 1, // 活动id，非必填
  "game": "yxzj" // 游戏code，非必填
}

1
2
3
4
5
6

# 返回参数

{
  "code": 0,
  "msg": "",
  "tid": "xxxxxxxxxxxxxxx"
}

1
2
3
4
5

# 4. 验证码校验接口

# 使用说明

中台传给平台手机号和验证码，获取平台用户信息

# 路由

/tencent/livelink/user/getUserByPhoneCode

# 方法

POST（application/json）

# 请求参数

{
  "phone": "13511112222", // 手机号，必填
  "code": "123456", // 验证码，必填
  "userIp": "192.168.1.1" // 用户IP，必填
}

1
2
3
4
5

# 返回参数

{
  "code": 0,
  "msg": "",
  "tid": "xxxxxxxxxxxxxxx",
  "data": {
    "userId": "xxxxxx", // 必传
    "nickName": "昵称", // 非必传
    "avatar": "http://123.com/1.jpg" // 非必传
  }
}

1
2
3
4
5
6
7
8
9
10

# 5. 获取用户信息接口

# 使用说明

中台传给平台 userId，获取平台用户信息

# 路由

/tencent/livelink/user/getUserById

# 方法

POST（application/json）

# 请求参数

{
  "userId": "xxxxxx" // 用户id，必填
}

1
2
3

# 返回参数

{
  "code": 0,
  "msg": "",
  "tid": "xxxxxxxxxxxxxxx",
  "data": {
    "userId": "xxxxxx", // 必传
    "nickName": "昵称", // 非必传
    "avatar": "http://123.com/1.jpg" // 非必传
  }
}

1
2
3
4
5
6
7
8
9
10

← 游戏账号绑定接入平台道具条件发货接入 →