跳到主要内容

获取用户问卷列表

重要提示

该功能为 尊享版 付费功能,如未升级,请先 升级 后再使用

接口概述

  • 功能:获取个人或者团队下的问卷列表
  • 请求方式:GET
  • 请求地址:/api/surveys?appid={appid}&access_token={access_token}&user_id={50000000001}

请求参数

参数名类型参数位置描述示例值
user_idintegerqueryString用户ID或者团队ID,团队授权可以使用该参数,团队ID可以从 https://wesurvey.com 右上角头像-团队管理中获取292192
openidstringqueryString用户唯一标识,第三方应用授权可以使用该参数,从网页授权的回调中获得abcdefg
pageintegerqueryString当前页码1
per_pageintegerqueryString每页显示条数20

响应参数

参数名类型描述
totalinteger总条数
listarray[object]问卷列表
list[_].idinteger问卷ID
list[_].hashstringhash
list[_].titlestring问卷标题
list[_].stateinteger状态,0:草稿, 2:回收中, 3:暂停回收

响应示例

  • 请求成功
{
"code": "OK",
"error": {
"type": "",
},
"data": {
"total": 3,
"list": [
{
"id": 292189,
"hash": "65c6",
"title": "问卷标题",
"state": 2
},
{
"id": 292190,
"hash": "5e13",
"title": "问卷标题",
"state": 2
},
{
"id": 292192,
"hash": "d082",
"title": "问卷标题",
"state": 2
}
]
},
"request_id": "e4b27037-d876-427d-95c7-d5a737dd1677"
}
  • 请求失败
{
"code": "InvalidArgument",
"error": {
"type": "invalid_argument",
},
"data": {},
"request_id": "ddec96d2-165e-4f3e-8a64-2057db116983"
}

错误码

error.type 错误代码错误描述
claim_error权限校验错误
invalid_argument参数校验不通过