experience.md 3.8 KB

经历填写页 API 接口文档 (pages/experience)

1. 获取全量经历列表

  • 接口说明: 用于进入经历页面时,一次性获取用户的教育、工作、项目经历列表,进行分类展示。
  • 请求路径: /resume/experience
  • 请求方法: GET
  • 公共头部: Authorization: Bearer {Token}
  • 接口返回 JSON 数据:
字段名 类型 说明 示例值
code Number 状态码 200
msg String 提示信息 "获取成功"
data Object 数据详情 { ... }
data.education Array 教育经历列表 [ ... ]
data.work Array 工作经历列表 [ ... ]
data.project Array 项目经历列表 [ ... ]

2. 教育经历管理

2.1 添加/更新教育经历

  • 接口说明: 保存教育经历。如果传递 id 则为更新,不传递则为新增。
  • 请求路径: /resume/education
  • 请求方法: POST
  • 接口参数:
参数名 类型 必填 说明 示例值
id Number 经历 ID (更新时必填) 123
school String 学校名称 "清华大学"
degree String 学历: 本科, 硕士, 博士 "本科"
major String 专业 "会计学"
start_time String 开始时间 (YYYY-MM) "2019-09"
end_time String 结束时间 (YYYY-MM),不填则视为至今 "2023-06"
  • 接口示例:

    // 请求示例
    {
    "school": "清华大学",
    "degree": "本科",
    "major": "会计学",
    "start_time": "2019-09",
    "end_time": "2023-06"
    }
    

2.2 删除教育经历

  • 请求路径: /resume/education/{id}
  • 请求方法: DELETE

3. 工作经历管理

3.1 添加/更新工作经历

  • 接口说明: 保存工作经历。
  • 请求路径: /resume/work
  • 请求方法: POST
  • 接口参数:
参数名 类型 必填 说明 示例值
id Number 经历 ID 456
company String 公司名称 "XX审计师事务所"
position String 职位名称 "审计助理"
start_time String 开始时间 "2023-07"
end_time String 结束时间,不填为至今 "2024-03"
content String 工作内容描述 "负责财务报表审计..."

3.2 删除工作经历

  • 请求路径: /resume/work/{id}
  • 请求方法: DELETE

4. 项目经历管理

4.1 添加/更新项目经历

  • 接口说明: 保存项目经历。
  • 请求路径: /resume/project
  • 请求方法: POST
  • 接口参数:
参数名 类型 必填 说明 示例值
id Number 经历 ID 789
name String 项目名称 "XX大型国企年度审计项目"
role String 在项目中担任的角色 "项目负责人"
start_time String 项目开始时间 "2023-11"
end_time String 项目结束时间 "2024-01"
desc String 项目描述/职责 "负责现场审计工作的全面协调..."

4.2 删除项目经历

  • 请求路径: /resume/project/{id}
  • 请求方法: DELETE

5. 辅助接口:行业/职位选择

  • 接口说明: 用于在填写经历或意向时,获取层级化的行业或职位数据列表。
  • 请求路径: /common/category-list
  • 请求方法: GET
  • 接口参数:
    • type: industry (行业), position (职位)
  • 返回 JSON 示例:

    {
    "code": 200,
    "data": [
    {
      "id": 1,
      "name": "财务/审计/税务",
      "children": [
        { "id": 101, "name": "审计经理" },
        { "id": 102, "name": "审计助理" }
      ]
    }
    ]
    }