考试星数据接口文档

• 考试星登录接口文档
• 考试星数据接口文档
• 考试星对外推送接口文档
• 示例代码
• SHA256加密示例（java）
• 上传人脸识别照片

1.api接口说明

• 考试星api接口采用jwt规范。Json web token (JWT), 是为了在网络应用环境间传递声明而执行的一种基于JSON的开放标准（(RFC 7519)。JWT调用示例代码

2.api参数配置

• appId : 客户唯一标识符，由考试星提供，例如：14343。
• appKey : 用于加密jwt，由考试星提供，例如：xf5ha3h67h4Ger34wh35p345h4。
• 获取方式：【管理员后台：系统设置->更多设置->开发者信息管理】

3.api统一接口地址

• 地址： https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo
• **jwtInfo：**jwt_info是用户根据jwt规范，用app_key将过期时间、action_id加密，生成的加密字符串

4.生成加密jwtInfo（java示例）

(1).安装依赖

<dependency>
  <groupId>io.jsonwebtoken</groupId>
  <artifactId>jjwt</artifactId>
  <version>0.7.0</version>

(2).生成加密字符串

生成jwtInfo加密字符串

  import io.jsonwebtoken.Jwts;
  String appKey = “xf5ha3h67h4Ger34wh35p345h4”
  String jwtInfo = Jwts.builder()
           .claim("exp", System. currentTimeMillis() + 1000*10)
              .claim("action_id", "201")
            .signWith(SignatureAlgorithm.HS256,app_key.getBytes("UTF-8")).compact();

(3).加密参数解释

appKey：加密的私钥，由考试星提供。
exp：过期时间。
action_id：表示请求的数据类型(注意是下划线)。

5.action_id参数解释

不同的action_id代表不同的请求行为，目前开放的请求行为如下：

6.当前开放的请求接口

（1）考试信息列表接口：

请求地址：https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo

请求方法：post

请求参数：

返回结果：

（2）考生分数列表接口：

请求地址：https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo

请求方法：post

请求参数：

返回结果：

（3）试卷试题列表接口：

请求地址：https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo

请求方法：post

请求参数：

返回结果：

（4）考生答案列表接口：

请求地址：https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo

请求方法：post

请求参数：

返回结果：

（5）在线学习内容列表接口：

请求地址：https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo

请求方法：post

请求参数：

返回结果：

（6）在线学习时长列表接口：

请求地址：https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo

请求方法：post

请求参数：

返回结果：

（7）获取考生可见考试和考试结果整合列表

请求地址：https://api.kaoshixing.com/api/company/data/:appId/?jwt=:jwtInfo

请求方法：post

请求参数：

返回结果：