创建问卷
接口概述
- 功能：使用纯文本创建问卷
- 请求方式： POST
- 请求地址：/api/surveys?appid={appid}&access_token={access_token}
请求参数
| 参数名 | 类型 | 必须 | 参数位置 | 描述 | 示例值 |
|---|---|---|---|---|---|
| user_id | integer | 是 | body | 用户ID | 60000000001，从【工作台右上角头像 - 个人中心】获得 |
| org | integer | 是 | body | 团队ID | 60000000002，从【工作台右上角头像 - 团队管理 - 点击团队名称】获得 |
| project_id | integer | 否 | body | 项目ID | 1234，从项目列表接口获得 |
| text | string | 是 | body | 问卷内容文本 | 回车替换为"\n" |
| scene | integer | 否 | body | 问卷场景 | 场景，参考问卷场景 |
请求体示例
{
"org":60000000002,
"user_id":60000000001,
"text":"文本编辑问卷题目\n\n为了给您提供更好的服务，希望您能抽出几分钟时间，将您的感受和建议告诉我们，我们非常重视每位用户的宝贵意见，期待您的参与！现在我们就马上开始吧!\n\n请输入题目标题[单选题]\n选项\n选项\n\n请输入题目标题[多选题]\n选项\n选项\n\n请输入题目标题[下拉题]\n选项\n选项\n\n=== 分页 ===\n\n请输入题目标题[单行文本题]\n\n请输入题目标题[多项填空题]\n填空1： ____\n\n请输入题目标题[多行文本题]\n\n请输入题目标题[量表题](5分表示非常满意，1分表示非常不满意，分值越低表示满意度越低)\n1~5\n\n请输入描述[段落说明]\n\n请输入题目标题[地理位置题]\n\n"
}
文本示例
请注意：下方的文本内容，放入请求体 POST body 时，
换行请使用\n代替。更多题型语法见下方说明。
[必填] 问卷标题
[可选] 问卷引导语
这是题目的标题[单行文本题]
这是题目的标题[单选题](这是题目描述)
选项A
选项B
这是题目的标题[量表题](这是题目的描述)
1~5
这是题目的标题[多项填空题](这是题目的描述)
填空的内容，填空1：____ 填空2：____
===分页===
这是题目的标题[联动题](这是题目的描述)
第一层 第二层
第一层答案 A
+第二层答案 A1
+第二层答案 A1
第一层答案 B
+第二层答案 B1
+第二层答案 B2
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| survey_id | integer | 问卷ID |
| hash | string | 问卷Hash |
响应示例
- 请求成功
{
"code": "OK",
"error": {
"type": ""
},
"data": {
"survey_id": 716128,
"hash": "859f"
},
"request_id": "7972b868-8303-43ba-b095-54207040412c"
}
- 请求失败
{
"code": "InvalidArgument",
"error": {
"type": "invalid_text_format",
},
"data": {},
"request_id": "ddec96d2-165e-4f3e-8a64-2057db116983"
}
错误码
| error.type 错误代码 | 错误描述 |
|---|---|
| permission_denied | 无创建权限 |
| invalid_text_format | 文本内容格式错误 |
| invalid_argument | 参数校验不通过 |
| resource_exhausted | 创建数量超过限制 |
题型语法说明
单选题
这是题目的标题[单选题](这是题目的描述)
选项A
选项B
选项C
多选题
这是题目的标题[多选题](这是题目的描述)
选项A
选项B
选项C
下拉题
这是题目的标题[下拉题](这是题目的描述)
选项A
选项B
选项C
排序题
这是题目的标题[排序题](这是题目的描述)
选项A
选项B
选项C
单行文本题
这是题目的标题[单行文本题](这是题目的描述)
多行文本题
这是题目的标题[多行文本题](这是题目的描述)
日期时间题
这是题目的标题[日期时间题](这是题目的描述)
地理位置题
这是题目的标题[地理位置题](这是题目的描述)
文本描述题
这是题目的标题[文本描述题](这是题目的描述)
附件题
这是题目的标题[附件题](这是题目的描述)
手写签名题
这是题目的标题[手写签名题](这是题目的描述)
多项填空题
这是题目的标题[多项填空题](这是题目的描述)
填空的内容，填空1：____ 填空2：____
量表题
这是题目的标题[量表题](这是题目的描述)
1~5
联动题
这是题目的标题[联动题](这是题目的描述)
第一层 第二层
第一层答案 A
+第二层答案 A1
+第二层答案 A1
第一层答案 B
+第二层答案 B1
+第二层答案 B2
矩阵单选题
请注意：以下语法中的
换行符放入接口请求的 POST body 时，需要换成\n，否则会报错。
这是题目的标题[矩阵单选题](这是题目的描述)
选项A 选项B 选项C
子问题1
子问题2
矩阵多选题
这是题目的标题[矩阵多选题](这是题目的描述)
选项A 选项B 选项C
子问题1
子问题2
矩阵量表题
这是题目的标题[矩阵量表题](这是题目的描述)
1~5
子问题1
子问题2