用户管理接口
重新生成发布问卷
接口概述
- 功能:重新生成发布问卷,当问卷内容有修改时调用,返回新的问卷访问地址以供使用
- 请求方式:POST
- 请求地址: /dw-open-api/survey/repub-survey.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appId | string | 是 | 平台分配的appId |
| dwVersion | string | 否 | 应用版本(可选,默认v6) |
| nonce | string | 是 | 随机字符串 |
| signature | string | 是 | 签名 |
| surveyId | string | 是 | 项目surveyId |
| timestamp | string | 是 | 当前时间戳 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/repub-survey.do?appId=afsd&nonce=dsfa&signature=asdf&surveyId=1f677c5e-0983-40fc-b8a7-c59ec496362a×tamp=647685415返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": "http://192.168.5.43:9999//#/v6/diaowen/an/ri4585u7xqi"
}创建一个新问卷
接口概述
- 功能:创建新问卷,提交问卷基本信息并返回新建问卷的详细信息及唯一标识
- 请求方式:POST
- 请求地址: /dw-open-api/survey/survey-add.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appId | string | 是 | 平台分配的appId |
| groupId1 | string | 否 | 分组场景ID |
| groupId2 | string | 否 | 分组类型ID |
| nonce | string | 是 | 随机字符串 |
| signature | string | 是 | 签名 |
| surveyName | string | 是 | 问卷名称 |
| timestamp | string | 是 | 当前时间戳 |
| userId | string | 是 | 问卷所属用户ID |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/survey-add.do?appId=asdfjhy&nonce=dfg&signature=dsf&surveyName=%E6%B5%8B%E8%AF%95%E5%8D%B7111×tamp=11123456111&userId=4b56fffa-8d97-48f1-b65e-3793758aab58返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": {
"id": "07d6556a-8023-4bbd-83fe-fabd12ae1560",
"sid": "d9mw0e2",
"surveyName": "测试卷111",
"surveyNameText": null,
"userId": "4b56fffa-8d97-48f1-b65e-3793758aab58",
"createDate": 1755676721289,
"surveyState": 0,
"surveyQuNum": 0,
"bindId": null
}
}获取某个问卷的详细信息
接口概述
- 功能:获取指定问卷详细信息,传入问卷 ID 返回问卷的基本信息及状态数据
- 请求方式:GET
- 请求地址: /dw-open-api/survey/survey-info.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appId | string | 是 | 平台分配的appId |
| nonce | string | 是 | 随机字符串 |
| signature | string | 是 | 签名 |
| surveyId | string | 是 | 问卷ID |
| timestamp | string | 是 | 当前时间戳 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/survey-info.do?appId=asdf&nonce=gsadf&signature=adsf&surveyId=1f677c5e-0983-40fc-b8a7-c59ec496362a×tamp=123654789返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": {
"id": "1f677c5e-0983-40fc-b8a7-c59ec496362a",
"sid": "ri4585u7xqi",
"surveyName": "AAAA",
"surveyNameText": "未命名问卷",
"userId": "1",
"createDate": 1755573744000,
"surveyState": 1,
"surveyQuNum": 0,
"bindId": null
}
}获取问卷相关操作地址,在第三方平台直接打开
接口概述
- 功能:获取问卷操作地址,返回可在第三方平台直接打开的问卷访问链接
- 请求方式:GET
- 请求地址: /dw-open-api/survey/survey-url.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appId | string | 是 | 平台分配的appId |
| dwVersion | string | 否 | 应用版本(可选,默认v6) |
| nonce | string | 是 | 随机字符串 |
| signature | string | 是 | 签名 |
| surveyId | string | 是 | 项目surveyId |
| timestamp | string | 是 | 当前时间戳 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/survey-url.do?appId=fdsg&dwVersion=v8&nonce=dsfadfad&signature=jdajd&surveyId=1f677c5e-0983-40fc-b8a7-c59ec496362a×tamp=1235465789返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": "redirect:http://192.168.5.43:9999//#/v8/diaowen/an/ri4585u7xqi"
}获取系统企业的问卷列表
接口概述
- 功能:获取系统企业所有问卷列表,支持分页与条件筛选,返回问卷详细信息及访问链接
- 请求方式:GET
- 请求地址: /dw-open-api/survey/sys-survey-list.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appId | string | 是 | 平台分配的appId |
| nonce | string | 是 | 随机字符串 |
| pageNo | integer($int32) | 否 | 页码,默认值1 |
| pageSize | integer($int32) | 否 | 页数据大小,默认值10 |
| signature | string | 是 | 签名 |
| surveyName | string | 否 | 问卷名称 |
| surveyState | integer($int32) | 否 | 问卷状态 |
| timestamp | string | 是 | 当前时间戳 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/sys-survey-list.do?appId=asd&nonce=sads&pageNo=1&pageSize=1&signature=adsa×tamp=132456返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": {
"pageNo": 1,
"pageSize": 1,
"totalPage": 43,
"result": [
{
"id": "07d6556a-8023-4bbd-83fe-fabd12ae1560",
"sid": "d9mw0e2",
"surveyName": "测试卷111",
"surveyNameText": null,
"userId": "4b56fffa-8d97-48f1-b65e-3793758aab58",
"createDate": 1755676721000,
"surveyState": 0,
"surveyQuNum": 0,
"bindId": null,
"userName": "nb",
"surveyAnswerUrl": "http://192.168.5.43:9999//#/v8/diaowen/an/d9mw0e2"
}
],
"totalItems": 43
}
}获取系统企业的问卷列表
接口概述
- 功能:获取系统企业所有问卷列表,支持分页与条件筛选,返回问卷详细信息及访问链接
- 请求方式:POST
- 请求地址: /dw-open-api/survey/sys-survey-list.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appId | string | 是 | 平台分配的appId |
| nonce | string | 是 | 随机字符串 |
| pageNo | integer($int32) | 否 | 页码,默认值1 |
| pageSize | integer($int32) | 否 | 页数据大小,默认值10 |
| signature | string | 是 | 签名 |
| surveyName | string | 否 | 问卷名称 |
| surveyState | integer($int32) | 否 | 问卷状态 |
| timestamp | string | 是 | 当前时间戳 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/sys-survey-list.do?appId=fda&nonce=puoi&pageNo=1&pageSize=1&signature=dsaf×tamp=123456798返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": {
"pageNo": 1,
"pageSize": 1,
"totalPage": 43,
"result": [
{
"id": "07d6556a-8023-4bbd-83fe-fabd12ae1560",
"sid": "d9mw0e2",
"surveyName": "测试卷111",
"surveyNameText": null,
"userId": "4b56fffa-8d97-48f1-b65e-3793758aab58",
"createDate": 1755676721000,
"surveyState": 0,
"surveyQuNum": 0,
"bindId": null,
"userName": "nb",
"surveyAnswerUrl": "http://192.168.5.43:9999//#/v8/diaowen/an/d9mw0e2"
}
],
"totalItems": 43
}
}修改问卷的状态
接口概述
- 功能:修改指定问卷的状态并返回更新后的问卷信息
- 请求方式:POST
- 请求地址: /dw-open-api/survey/up-survey-status.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appId | string | 是 | 平台分配的appId |
| nonce | string | 是 | 随机字符串 |
| signature | string | 是 | 签名 |
| surveyId | string | 是 | 问卷ID |
| surveyStatus | integer($int32) | 是 | 问卷状态 |
| timestamp | string | 是 | 当前时间戳 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/up-survey-status.do?appId=qewrm&nonce=zvcx&signature=poiu&surveyId=1f677c5e-0983-40afc-b8a7-c59ec496362a&surveyStatus=123×tamp=963258741返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": {
"id": "1f677c5e-0983-40fc-b8a7-c59ec496362a",
"sid": "ri4585u7xqi",
"surveyName": "AAAA",
"surveyNameText": "未命名问卷",
"userId": "1",
"createDate": 1755573744000,
"surveyState": 123,
"surveyQuNum": 0,
"bindId": null
}
}获取某个用户的问卷列表
接口概述
- 功能:获取指定用户下的问卷列表
- 请求方式:GET
- 请求地址: /dw-open-api/survey/user-survey-list.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| answerNum | integer($int32) | 否 | 答卷量大于 |
| appId | string | 是 | 平台分配的appId |
| endTime | string | 否 | 创建时间小于 |
| groupId1 | string | 否 | 行业ID |
| groupId2 | string | 否 | 场景ID |
| loginName | string | 否 | 用户登录名称,【userId,loginName,thirdUserId 至少传一个】 |
| nonce | string | 是 | 随机字符串 |
| pageNo | integer($int32) | 否 | 页码,默认值1 |
| pageSize | integer($int32) | 否 | 页数据大小,默认值10 |
| signature | string | 是 | 签名 |
| startTime | string | 否 | 创建时间大于 |
| surveyName | string | 否 | 问卷名称 |
| surveyState | integer($int32) | 否 | 问卷状态 |
| thirdUserId | string | 否 | 第三方平台ID【userId,loginName,thirdUserId 至少传一个】 |
| timestamp | string | 是 | 当前时间戳 |
| userId | string | 否 | 用户ID【userId,loginName,thirdUserId 至少传一个】 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/user-survey-list.do?appId=uoip&nonce=as&pageNo=1&pageSize=1&signature=pcx×tamp=2363875441&userId=4b56fffa-8d97-48f1-b65e-3793758aab58返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": {
"pageNo": 1,
"pageSize": 1,
"totalPage": 1,
"result": [
{
"id": "07d6556a-8023-4bbd-83fe-fabd12ae1560",
"sid": "d9mw0e2",
"surveyName": "测试卷111",
"surveyNameText": null,
"userId": "4b56fffa-8d97-48f1-b65e-3793758aab58",
"createDate": 1755676721000,
"surveyState": 0,
"surveyQuNum": 0,
"bindId": null,
"userName": "nb",
"surveyAnswerUrl": "http://192.168.5.43:9999//#/v8/diaowen/an/d9mw0e2"
}
],
"totalItems": 1
}
}获取某个用户的问卷列表
接口概述
- 功能:获取指定用户下的问卷列表
- 请求方式:POST
- 请求地址: /dw-open-api/survey/user-survey-list.do
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| answerNum | integer($int32) | 否 | 答卷量大于 |
| appId | string | 是 | 平台分配的appId |
| endTime | string | 否 | 创建时间小于 |
| groupId1 | string | 否 | 行业ID |
| groupId2 | string | 否 | 场景ID |
| loginName | string | 否 | 用户登录名称,【userId,loginName,thirdUserId 至少传一个】 |
| nonce | string | 是 | 随机字符串 |
| pageNo | integer($int32) | 否 | 页码,默认值1 |
| pageSize | integer($int32) | 否 | 页数据大小,默认值10 |
| signature | string | 是 | 签名 |
| startTime | string | 否 | 创建时间大于 |
| surveyName | string | 否 | 问卷名称 |
| surveyState | integer($int32) | 否 | 问卷状态 |
| thirdUserId | string | 否 | 第三方平台ID【userId,loginName,thirdUserId 至少传一个】 |
| timestamp | string | 是 | 当前时间戳 |
| userId | string | 否 | 用户ID【userId,loginName,thirdUserId 至少传一个】 |
请求示例
http://192.168.5.43:9999/dw-open-api/survey/user-survey-list.do?appId=dsaf&nonce=dsafvxxc&pageNo=1&pageSize=1&signature=dsaf×tamp=123578964&userId=4b56fffa-8d97-48f1-b65e-3793758aab58返回值
json
{
"resultCode": 200,
"resultMsg": "执行成功",
"data": {
"pageNo": 1,
"pageSize": 1,
"totalPage": 1,
"result": [
{
"id": "07d6556a-8023-4bbd-83fe-fabd12ae1560",
"sid": "d9mw0e2",
"surveyName": "测试卷111",
"surveyNameText": null,
"userId": "4b56fffa-8d97-48f1-b65e-3793758aab58",
"createDate": 1755676721000,
"surveyState": 0,
"surveyQuNum": 0,
"bindId": null,
"userName": "nb",
"surveyAnswerUrl": "http://192.168.5.43:9999//#/v8/diaowen/an/d9mw0e2"
}
],
"totalItems": 1
}
}
