Skip to main content
Version: latest

创建问卷

接口概述#

  • 功能：使用纯文本创建问卷
  • 请求方式： POST
  • 请求地址：/api/surveys?appid={appid}&access_token={access_token}

请求参数#

参数名类型必须参数位置描述示例值
user_idinteger是body用户ID60000000001，从【工作台右上角头像 - 个人中心】获得
orginteger是body团队ID60000000002，从【工作台右上角头像 - 团队管理 - 点击团队名称】获得
textstring是body问卷内容文本回车替换为"\n"

请求体示例#

{    "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_idinteger问卷ID
hashstring问卷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