APESK(才储)接口文档(案例







①接口介绍

APESK接口分 两种模式:

第一种是 简易iframe模式。直接使用iframe框架把APESK测试入口页面嵌入客户网站,测试用户的整个测试过程在客户网站进行,测试用户无需打开才储网页。该模式需要客户有了解iframe的技术人员。

第二种是 高级iframe传递参数模式(仅限3W套餐用户):客户将本接口通过客户端网站与才储测试之间的用户数据传递,实现用户直接在客户网站进行测试及查看报告。此方式适用于有用户系统的网站。需要较专业的技术人员配合实施。 以下是高级iframe传递参数模式的具体实施流程:



②iframe地址 / 传递的参数 流程(高级iframe+传参模式 , 采用url传参)

1、注册才储账号,www.apesk.com/zc 注册完成之后,通知才储接口技术(Q 6589105)绑定需要接口的域名。

2、iframe操作。若使用简易iframe模式,直接iframe才储后台的测试入口,并放入网站即可。实例

3、若使用接口传参模式,需要技术人员先Iframe才储接口页:




接口及传参说明:


接口地址:http://www.apesk.com/h/go_zy_dingzhi.asp (兼容手机及PC)

接口所需传参包括

1、才储账户:hruserid (自助注册

2、测试序列号:checkcode (告知才储客服你的才储账号,才储客服提供序列号)

3、测试量表名:l (区分不同测试项目的静态参数。测试时暂用OPQ测试的量表名:Management-potential)

4、测试用户名:test_name (客户动态传递)

5、测试用户编号(需要保证唯一性):test_email (客户动态传递)

接口地址URL参数实例:

http://www.apesk.com/h/go_zy_dingzhi.asp?checkcode=1GXSPX9JYQWC9TPHPZ&hruserid=lar.huang@outlook.com&l=Management-potential&test_name=test123&test_email=test@sina1436.com


点击查看iframe接口页面实例


特别注意:APESK网站为GB2312编码,若客户网站为utf8+PHP,中文的test_name则需要先utf8转GB2312 然后用PHP urlencode。否则会出现乱码。 若为JAVA语言网站,中文的test_name的转码方法参见:



请留意在servlet传递给参数的时候必须保证是统一编码。

若为.net+utf8转码参见:






3、添加数据库字段。 在客户自己的用户表上添加两个字段, 一个是report_id ,一个是liangbiao 。 均为字符型(长度50)。 添加好字段后,做一个receive页面做好接收准备,根据APESK传递给过来的test_email更新report_id和liangbiao。

接收文件后是如何获取到APESK传递过来的参数的?在测试后的计算分析页面内,APESK会提交如下的代码进行URL传参:


比如该客户将http://www.it-cast.com/get.aspx设置为接收文件地址(此路径及文件需真实存在),该文件的任务是采集通过URL传递来的各项参数后,根据测试者的test_email更新用户表的report_id和liangbiao。

注意:接收参数文件的路径需要告知才储客服,进行绑定操作。比如上述客户应该将:http://www.it-cast.com/get.aspx 这个路径告知才储客服。


点击查看(需客户自己根据自己网站语言写的)接收页面逻辑参考


4、如果需要测试对象测试完成就直接显示报告,可以尝试做一个探测的逻辑,比如用户表里面一旦接受到才储端反馈的报告id等参数,就直接将当前答题页面刷新显示为报告地址页面,完全脱离答题的iframe(以解决答题界面和报告界面的iframe高度差异导致的报告显示不完整问题)。或者使用更简单的方法,比如用script语言的:window.open('呈现页面路径','_blank')。让需要呈现给用户的页面直接跳出iframe。

5、签署商务合同后,通知才储接口技术提供量表授权码、liangbiao名称和报告地址的关联表(如liangibao为:HBDI,则报告地址为: http://www.apesk.com/mensa/common_report_getid/hbdi_report_admin.asp?id=1731(此id即为获取的report_id)。





③接口完成






© 才储团队