注册第三方账号
#
接口概述- 功能:使用该接口可以为使用者创建一个账号,用于单点登录进入腾讯问卷系统。
- 使用场景:你的 APP 或平台(称为腾讯问卷的第三方)已经有一套用户系统,你的用户需要使用腾讯问卷进行问卷编辑、投放及填答,最终你的 APP 或平台能够追溯编辑者、回答者的身份。使用该接口注册用户后,再通过
获取一次性登录码
和单点登录
接口进行静默登录,用户即可以无缝对接到腾讯问卷中。 - 请求方式:POST
- 请求地址:/api/sso/users
#
请求参数参数名 | 类型 | 参数位置 | 描述 | 示例值 |
---|---|---|---|---|
openid | string | body | 第三方用户标识,用于辨别来自该第三方应用/平台的用户 长度不超过128个字符 在问卷系统中视 appid+openid 确定用户 | c12ba6e8606d11eba20cf64d5fc81bbe |
nickname | string | body | 用户昵称长度不超过64个字符 | 张三 |
avatar | string | body | 用户头像长度不超过255个字符 | https://wj.gtimg.com/default/default_headimg.png |
#
响应参数参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
user_id | integer(uint64) | 问卷系统用户ID | 60000208205 |
respondent_id | integer(uint64) | 问卷系统用户对应的回答者身份ID,用于对应回答详情中的 "qq" 字段 | 60000683396 |
#
响应示例{ "code": "OK", "error": { "type": "" }, "data": { "user_id": 60000208205, "respondent_id": 60000683396 }, "request_id": "d84e884b-3bc5-419d-9cc0-d6d6d14e68b6"}
#
错误码error.type 错误代码 | 错误描述 |
---|---|
user_create_error | 注册用户失败 |
openid_existed | 用户已存在,请检查 openid |