获取用户问卷列表
接口概述
- 功能:获取个人或者团队下的问卷列表
- 请求方式:GET
- 请求地址:/api/surveys?appid={appid}&access_token={access_token}&user_id={50000000001}
请求参数
参数名 | 类型 | 参数位置 | 描述 | 示例值 |
---|---|---|---|---|
user_id | integer | queryString | 用户ID或者团队ID,团队授权可以使用该参数,团队ID可以从 https://wesurvey.com 右上角头像-团队管理中获取 | 292192 |
openid | string | queryString | 用户唯一标识,第三方应用授权可以使用该参数,从网页授权的回调中获得 | abcdefg |
page | integer | queryString | 当前页码 | 1 |
per_page | integer | queryString | 每页显示条数 | 20 |
响应参数
参数名 | 类型 | 描述 |
---|---|---|
total | integer | 总条数 |
list | array[object] | 问卷列表 |
list[_].id | integer | 问卷ID |
list[_].hash | string | hash |
list[_].title | string | 问卷标题 |
list[_].state | integer | 状态,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 | 参数校验不通过 |