Skip to main content
Version: latest

注册第三方账号

接口概述#

  • 功能:使用该接口可以为使用者创建一个账号,用于单点登录进入腾讯问卷系统。
  • 使用场景:你的 APP 或平台(称为腾讯问卷的第三方)已经有一套用户系统,你的用户需要使用腾讯问卷进行问卷编辑、投放及填答,最终你的 APP 或平台能够追溯编辑者、回答者的身份。使用该接口注册用户后,再通过获取一次性登录码单点登录接口进行静默登录,用户即可以无缝对接到腾讯问卷中。
  • 补充说明:该功能也支持回答端对接,可以搭配数据推送功能,实现填答者身份传入问卷、填答后身份回传。
  • 请求方式:POST
  • 请求地址:/api/sso/users?appid={appid}&access_token={access_token}

请求参数#

参数名类型参数位置描述示例值
openidstringbody第三方用户标识,用于辨别来自该第三方应用/平台的用户
长度不超过128个字符
在问卷系统中视 appid+openid 确定用户
c12ba6e8606d11eba20cf64d5fc81bbe
nicknamestringbody用户昵称长度不超过64个字符张三
avatarstringbody用户头像长度不超过255个字符https://wj.gtimg.com/default/default_headimg.png

响应参数#

参数名类型描述示例值
user_idinteger(uint64)问卷系统用户ID60000208205
respondent_idinteger(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