帮助中心 >

免登录账户API

该功能接口仅限为旗舰版用户提供，需联系服务顾问开通。

问卷星接口说明

1、免登录接口

介绍

即单点登录接口，此接口适用于在已有用户体系下，用户可以在已有系统中点击问卷调查的模块即可直接使用问卷星的所有功能，无需另外再注册登录问卷星。

接口说明

请求方式：get

加密链接参数如下：

https://www.wjx.cn/partner/login.aspx?appid=&username=&mobile=&subuser=&ts=&sign=

subuser:子账户参数，从属于username（可以被username用户进行管理），可选
sign计算方法：
sign = sha1(appid+appkey+username+mobile+subuser+ts)

如页面返回信息：签名错误！请检查sign计算是否正确。

提示：如果需要在iframe中使用免登录接口，由于safari浏览器对cookie的限制，必须使用JS脚本的方式进行嵌入：
<script type='text/javascript' src='https://www.wjx.cn/handler/loginemed.ashx?url={url}&width=100%&height=100%'></script>
src中需要有3个参数：
{url}参数请使用https://www.wjx.cn/partner/login.aspx?appid=&username=&mobile=&ts=&sign=进行替换。width和height参数可选，默认为100%。

2、用户端接口

介绍

使用该接口，做为填写者的用户登录之后，可看到一个完善的填写者后台页面，查看到自己需要作答哪些问卷、已经完成了哪些问卷、积分排行等等信息。

接口说明

请求方式：get

加密链接参数如下：

http://www.wjx.cn/partner/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

sign计算方法：
sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

获取答题者单独列表接口（参数跟上面的一样）：
格式：JSON
a) 获取填写者的待参与列表：
地址：https://www.wjx.cn/partner/getqlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
sign计算方法：
sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

b) 获取填写者的已参与列表：
地址：https://www.wjx.cn/partner/getqlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
sign计算方法：
sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

c) 获取单份答卷详情链接：
地址：https://www.wjx.cn/partner/joinrelquery.aspx?appid=&username=&joiner=&activity=&joinid=&realname=&dept=&extf=&ts=&sign=
sign计算方法：
sign = sha1(appid+appkey+username+joiner+activity+joinid+realname+dept+extf+ts)

d) 自主拼接用户的单个问卷访问链接：

1、使用a) 获取填写者的待参与列表，提取单个问卷的访问链接，记录为ActivityUrl;

2、替换ActivityUrl中的ts为当前时间；

3、重新计算并替换partersign的值；

partersign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

3、获取管理员名下的问卷列表

介绍

通过此接口，可以获取某一个问卷管理员名下的的问卷列表。

数据获取方式：get

接口说明

加密链接参数如下：

http://www.wjx.cn/partner/getuserq.aspx?appid=&username=&ts=&folder=&sign=

appid：由问卷星分配

appkey：由问卷星分配

folder：用户名下的问卷文件夹名称。如加了该参数，则只会获取到指定文件夹里面的问卷数据，如果需要全部问卷数据，可以不加。

ts：为按秒计数的当前时间戳，通常对应time()函数，系统确认ts是在30s内，并且sign一致，就会自动登录

username：使用者的用户名或用户ID，由用户自己生成
sign计算方法：
sign = sha1(appid+appkey+username+ts+folder)

提示：此接口会有10分钟的缓存时间，新增的问卷可能需要10分钟以后才能获取。

数据格式：JSON

数据示例： [{"qid":"89767","name":"新考试","begindate":"2017-08-20 11:52:43","answercount":"5"},{"qid":"89819","name":"考试","begindate":"2017-08-18 21:21:35","answercount":"4"}]

4、获取答卷数据API

介绍

通过此接口可以直接会获取所有参与者的得分数据，包括：提交序号、参与者姓名、总分、提交时间、提交所用时间。只有答卷总数少于20000才能使用此接口。

数据获取方式：get

接口说明

加密链接参数如下：

http://www.wjx.cn/partner/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=&pagesize=

appid：由问卷星分配

appkey：由问卷星分配

activity：表示问卷的ID

ts：为按秒计数的当前时间戳，通常对应time()函数，系统确认ts是在30s内，并且sign一致，才能获取

pageindex：页码序号

pagesize : 每页数量，默认10条数据，每页最多不超过1000条数据
sign计算方法：
sign = sha1(appid+appkey+activity+ts)

数据格式：JSON

数据示例：

[{"parterjoiner":"test2","totalvalue":"15","index":"3","timetaken":"8","submittime":"2017-08-20 14:25:39"},{"parterjoiner":"test3","totalvalue":"15","index":"4","timetaken":"141","submittime":"2017-08-20 14:38:55"}]