用户模块

获取个人信息

请求链接: /user/getUserInfo
请求方式: POST
参数说明:

无参数

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
mobile	String	手机号
uid	Int	用户ID
haveSafeAnswer	Boolean	是否已设置安全答案
nickname	String	昵称
headUrl	String	头像URL
accountName	String	账号名称
countryId	Int	国家ID
email	String	邮箱
countryName	String	国家名称
isIdCard	Int	是否已实名认证
isVip	Int	是否开通高级服务
isNeedVerify	Int	是否需实名认证
deviceId	String	最新的极光设备ID
deviceIds	Array	绑定了极光所有设备ID
unreadMessageCount	Int	未读消息数量
amazonAlexa	Object	Amazon Alexa配置
googleHome	Object	Google Home配置
starchart	Object	星图配置
cloudStorage	Object	云存储配置

json

{
  "mobile": "",
  "uid": 16599773,
  "haveSafeAnswer": false,
  "nickname": "786612630",
  "headUrl": "",
  "accountName": "786612630@qq.com",
  "countryId": 9,
  "email": "786612630@qq.com",
  "countryName": "中国",
  "isIdCard": 0,
  "isVip": 0,
  "isNeedVerify": 0,
  "deviceId": "",
  "deviceIds": ["000", "111"],
  "unreadMessageCount": 30,
  "amazonAlexa": {
    "skillName": "Lock",
    "langs": [
      "美国",
      "加拿大",
      "英国",
      "澳大利亚",
      "法国",
      "意大利",
      "巴西",
      "印度"
    ]
  },
  "googleHome": {
    "actionName": "ScienerSmart",
    "langs": [
      "英语"
    ]
  },
  "starchart": {
    "starchartId": "1",
    "starchartPeerPublicKey": "2",
    "starchartPeerPrivateKey": "2"
  },
  "cloudStorage": {
    "status": 1,
    "days": 2,
    "expireTime": "2025-04-17 18:10:23",
    "remainDays": 1
  }
}

更新个人信息

请求链接: /user/updateUserInfo
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
headUrl	String	N	""	头像地址
nickname	String	N	"-"	昵称
lang	String	N	""	语言，请看语言常量
is_amazon_alexa	int	N	0	是否打开amazon alexa 0否 1是
is_google_home	int	N	0	是否打开google home 0否 1是

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

获取安全信息列表

请求链接: /safeAnswer/getQuestionList
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
countryCode	String	Y	86	如果是其他国家的，需要传国家代码，本国可以默认不传

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
firstList	Array	第一组问题列表
secondList	Array	第二组问题列表
thirdList	Array	第三组问题列表
question	String	问题内容
questionId	Int	问题ID

json

{
  "firstList": [
    {
      "question": "你第一次乘坐飞机去的是哪个城市？",
      "questionId": 1
    },
    {
      "question": "你的QQ号码是多少？",
      "questionId": 2
    },
    {
      "question": "你的第一个宠物叫什么名字？",
      "questionId": 3
    },
    {
      "question": "你爸爸是哪年出生的？",
      "questionId": 4
    },
    {
      "question": "你看的第一部电影叫什么名字？",
      "questionId": 5
    }
  ],
  "secondList": [
    {
      "question": "你最想从事的工作是什么？",
      "questionId": 6
    },
    {
      "question": "你的第一辆车是什么品牌？",
      "questionId": 7
    },
    {
      "question": "你的小名叫什么？",
      "questionId": 8
    },
    {
      "question": "你上高中时最喜欢的电影明星是谁？",
      "questionId": 9
    },
    {
      "question": "你大学是哪年毕业的？",
      "questionId": 10
    }
  ],
  "thirdList": [
    {
      "question": "你在哪个城市出生？",
      "questionId": 11
    },
    {
      "question": "你第一个老板的全名是什么？",
      "questionId": 12
    },
    {
      "question": "你在哪个城市遇到你的爱人？",
      "questionId": 13
    },
    {
      "question": "你最喜欢哪支NBA球队？",
      "questionId": 14
    },
    {
      "question": "你爷爷的名字是什么？",
      "questionId": 15
    }
  ]
}

获取已设置的安全信息

请求链接: /safeAnswer/getOwnQuestionList
请求方式: POST
参数说明:

无参数

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
answerId	Int	答案ID
answer	String	答案内容
uid	Int	用户ID
questionId	Int	问题ID
question	String	问题内容

json

[
  {
    "answerId": 31,
    "answer": "三亚332",
    "uid": 587,
    "questionId": 1,
    "question": "你第一次乘坐飞机去的是哪个城市？"
  },
  {
    "answerId": 32,
    "answer": "三亚2222",
    "uid": 587,
    "questionId": 7,
    "question": "你的第一辆车是什么品牌？"
  },
  {
    "answerId": 33,
    "answer": "1三亚2222",
    "uid": 587,
    "questionId": 7,
    "question": "你的第一辆车是什么品牌？"
  }
]

设置安全信息

请求链接: /safeAnswer/set
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
questionAndAnswerList	String	Y	"[{"questionId":"1","answer":"三亚","question":"你第一次乘坐飞机去的是哪个城市？","isWrong":false},{"questionId":"7","answer":"传祺","question":"你的第一辆车是什么品牌？","isWrong":false},{"questionId":"13","answer":"深圳","question":"你在哪个城市遇到你的爱人？","isWrong":false}]"	问题答案列表（JSON字符串）

questionAndAnswerList 格式说明：

questionId: 问题ID
answer: 答案内容
question: 问题内容
isWrong: 是否错误

json

[
  {
    "questionId": "1",
    "answer": "三亚",
    "question": "你第一次乘坐飞机去的是哪个城市？",
    "isWrong": false
  },
  {
    "questionId": "7",
    "answer": "传祺",
    "question": "你的第一辆车是什么品牌？",
    "isWrong": false
  },
  {
    "questionId": "13",
    "answer": "深圳",
    "question": "你在哪个城市遇到你的爱人？",
    "isWrong": false
  }
]

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

修改密码

请求链接: /user/changePassword
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
date	String	Y	"1689298549000"	时间戳
newPassword	String	Y	"f1ce0d10501f42a649f2035bb5830971"	新密码
oldPassword	String	Y	"f1ce0d10501f42a649f2035bb5830971"	旧密码

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

获取解绑手机号Token

⚠️ 已废弃（Deprecated） 此接口已被新的灵活换绑接口取代，建议使用 /user/flexibleBindToken 和 /user/flexibleBind 接口。新接口支持更灵活的验证方式，详见下方"灵活换绑"章节。

请求链接: /user/unbindPhoneToken
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
verificationCode	String	Y	"613915"	验证码

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
token	String	用作下一步修改请求参数

json

{
  "token": "613915"
}

获取解绑邮箱Token

⚠️ 已废弃（Deprecated） 此接口已被新的灵活换绑接口取代，建议使用 /user/flexibleBindToken 和 /user/flexibleBind 接口。新接口支持更灵活的验证方式，详见下方"灵活换绑"章节。

请求链接: /user/unbindEmailToken
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
verificationCode	String	Y	"613915"	验证码

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
token	String	用作下一步修改请求参数

json

{
  "token": "613915"
}

修改绑定邮箱

⚠️ 已废弃（Deprecated） 此接口已被新的灵活换绑接口取代，建议使用 /user/flexibleBindToken 和 /user/flexibleBind 接口。新接口支持更灵活的验证方式，详见下方"灵活换绑"章节。

请求链接: /user/bindEmail
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
email	String	Y	"18682150237@163.com"	新邮箱地址
verificationCode	String	Y	"613915"	验证码
unbindToken	String	N	"PYIlxRTCu3ESjSGPkoFWeavE"	如果是换绑则必填

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

修改绑定手机号

⚠️ 已废弃（Deprecated） 此接口已被新的灵活换绑接口取代，建议使用 /user/flexibleBindToken 和 /user/flexibleBind 接口。新接口支持更灵活的验证方式，详见下方"灵活换绑"章节。

请求链接: /user/bindPhone
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
countryCode	String	Y	"+86"	国家代码
account	String	Y	"13392170171"	手机号
verificationCode	String	Y	"470293"	验证码
unbindToken	String	N	"PYIlxRTCu3ESjSGPkoFWeavE"	如果是换绑则必填

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

灵活换绑-获取验证token

请求链接: /user/flexibleBindToken
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
verifyChannel	Int	Y	1	验证渠道：1-手机号 2-邮箱
verificationCode	String	Y	"123456"	验证码（6位数字）

说明：

用户选择用现有的邮箱或手机号验证身份
验证码需要先通过 /user/sendValidationCodeAuth 发送，codeType 使用 11（灵活换绑身份验证）
验证通过后返回token，有效期1小时

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	Object	返回数据
token	String	验证token（128位随机字符串）
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes",
  "token": "xK8mP2nQ5vR9wT3yU7zB1cD4eF6gH0jL..."
}

灵活换绑-执行绑定

请求链接: /user/flexibleBind
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
flexibleBindToken	String	Y	"xK8mP2nQ5vR9..."	第一步获取的验证token
bindType	Int	Y	2	绑定类型：1-手机号 2-邮箱
countryCode	String	N	"86"	国家区号（绑定手机号时必填）
account	String	Y	"newemail@example.com"	新的邮箱或手机号
verificationCode	String	Y	"123456"	新账号的验证码（6位数字）

说明：

使用第一步获取的 flexibleBindToken 进行身份验证
新账号的验证码需要先通过 /user/sendValidationCodeAuth 发送
- 绑定邮箱：codeType=6, channel=2
- 绑定手机号：codeType=3, channel=1
如果绑定的是已有类型（如已有邮箱再绑邮箱），则替换旧值
绑定成功后会同步更新云平台的账号信息

使用场景：

用手机号验证来绑定新邮箱
用邮箱验证来绑定新手机号
用手机号验证来更换手机号
用邮箱验证来更换邮箱

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

上传头像

请使用公共接口"获取文件上传参数"获取上传参数，然后调用 updateUserInfo 接口更新头像。

修改安全信息

请求链接: /safeAnswer/update
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
questionAndAnswerList	array	Y	[]	修改参数格式看下方代码块

questionAndAnswerList 格式说明：

answerId: 答案ID
answer: 答案内容
questionId: 问题ID

json

[
  {
    "answerId": "31",
    "answer": "三亚332",
    "questionId": "1"
  },
  {
    "answerId": "32",
    "answer": "三亚2222",
    "questionId": "7"
  },
  {
    "answerId": "33",
    "answer": "1三亚2222",
    "questionId": "7"
  }
]

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

获取微信公众号二维码

请求链接: /user/getMpWechatQrCode
请求方式: POST
参数说明:

无参数

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
qrCodeUrl	String	二维码URL

json

{
  "qrCodeUrl": "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHk8DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyZ1pKQmdKeUhmdUYxM3RseWhDMVQAAgTdiPplAwQAjScA"
}

设置微信公众号推送

请求链接: /user/setMpWechatPushSwitch
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
mpWechatPushSwitch	int	Y	1	0默认 1开关 2关闭

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

设置APP消息推送开关

请求链接: /user/setPushSwitch
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
appPushSwitch	int	Y	1	0/1 开关

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息

json

{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

绑定星图配置

请求链接: /userStarchart/bindUserStarchart
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
starchartId	String	Y	""	星图ID
starchartPeerPublicKey	String	Y	""	星图对等公钥
starchartPeerPrivateKey	String	Y	""	星图对等私钥

返回参数及示例:

参数	类型	描述
status	Int	状态码
statusText	String	提示信息
content	String	返回数据
starchartId	String	星图ID
starchartPeerPublicKey	String	星图对等公钥
starchartPeerPrivateKey	String	星图对等私钥

json

{
  "starchartId": "1",
  "starchartPeerPublicKey": "2",
  "starchartPeerPrivateKey": "2"
}

获取支持语言列表

请求链接: /lang/getList
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
无

返回参数及示例:

参数	类型	描述
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息
data	Object	返回数据

json

{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": {
    "zh_CN": "简体中文",
    "en_US": "English"
  }
}

获取语言包

请求链接: /lang/getList
请求方式: POST
参数说明:

名称	类型	是否必需	示例	描述
lang	string	Y	"zh_CN"	语言包编号，编号通过接口：8.18.1 获取支持语言列表，获取

返回参数及示例:

参数	类型	描述
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息
data	Object	返回数据

json

{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": {
    "lang": {
      "周一": "Monday",
      "周二": "Tuesday",
      "周三": "Wednesday",
      "周四": "Thursday",
      "周五": "Friday",
      "周六": "Saturday",
      "周日": "Sunday"
    }
  }
}

用户模块 ​

获取个人信息 ​

更新个人信息 ​

获取安全信息列表 ​

获取已设置的安全信息 ​

设置安全信息 ​

修改密码 ​

获取解绑手机号Token ​

获取解绑邮箱Token ​

修改绑定邮箱 ​

修改绑定手机号 ​

灵活换绑-获取验证token ​

灵活换绑-执行绑定 ​

上传头像 ​

修改安全信息 ​

获取微信公众号二维码 ​

设置微信公众号推送 ​

设置APP消息推送开关 ​

绑定星图配置 ​

获取支持语言列表 ​

获取语言包 ​

用户模块

获取个人信息

更新个人信息

获取安全信息列表

获取已设置的安全信息

设置安全信息

修改密码

获取解绑手机号Token

获取解绑邮箱Token

修改绑定邮箱

修改绑定手机号

灵活换绑-获取验证token

灵活换绑-执行绑定

上传头像

修改安全信息

获取微信公众号二维码

设置微信公众号推送

设置APP消息推送开关

绑定星图配置

获取支持语言列表

获取语言包