assessment.md 3.4 KB

测评与投递模块 API 接口文档 (pages/assessment)

1. 获取测评试题内容

  • 接口说明: 进入在线测评页面时,根据岗位或业务类型获取相应的题库。
  • 请求路径: /assessment/questions
  • 请求方法: GET
  • 公共头部: Authorization: Bearer {Token}
  • 接口参数:
参数名 类型 必填 说明 示例值
job_id Number 岗位 ID (针对特定岗位测评) 101
type String 业务类型: audit (审计类通用测评) "audit"
  • 接口返回 JSON 数据:
字段名 类型 说明 示例值
code Number 状态码 200
data Object 包装对象 { ... }
data.total_questions Number 总题数 60
data.time_limit Number 答题限时 (分钟) 30
data.questions Array 题目数组 [ ... ]
data.questions[].id Number 题目唯一 ID 1001
data.questions[].title String 题干描述 "以下哪项属于资产类科目?"
data.questions[].options Array 选项列表 ["A. 现金", "B. 收入", ...]

2. 提交答案并评分

  • 接口说明: 用户完成测评后提交所有答案,后端实时计算分数并更新岗位申请进度。
  • 请求路径: /assessment/submit
  • 请求方法: POST
  • 公共头部: Authorization: Bearer {Token}
  • 接口参数:
参数名 类型 必填 说明 示例值
job_id Number 关联的岗位 ID 101
answers Array 用户答案数组 [{ "q_id": 1001, "val": "A" }]
  • 接口返回 JSON 数据:
字段名 类型 说明 示例值
code Number 状态码 200
data Object 评分结果摘要 { ... }
data.score Number 总分 85
data.is_pass Boolean 是否通过进入投递环节 true

3. 获取测评报告详情

  • 接口说明: 用于展示测评结果页、雷达图及详细分析对比。
  • 请求路径: /assessment/report
  • 请求方法: GET
  • 接口参数: job_id
  • 接口返回 JSON 数据:
字段名 类型 说明 示例值
code Number 状态码 200
data Object 报告数据 { ... }
data.score Number 得分 88
data.dimensions Array 维度分布 (用于雷达图) [{ "name": "专业知识", "value": 90 }]
data.analysis String AI 综合分析评价文本 "该用户具备扎实的审计基础..."
data.comparison_avg Number 同岗位用户平均分 75

4. 确认投递简历

  • 接口说明: 在测评结果页,若符合要求,点击“投递”或“加入意向”完成最终动作。
  • 请求路径: /jobs/apply
  • 请求方法: POST
  • 接口参数:
参数名 类型 必填 说明 示例值
job_id Number 投递的目标岗位 ID 101
resume_type String 投递简历类型: online (在线简历), pdf (附件简历) "online"
pdf_id Number 若选择附件简历,需传附件 ID 55
  • 接口返回 JSON 数据:

    {
    "code": 200,
    "msg": "投递成功,请等待 HR 联系",
    "data": {}
    }