my.md 3.0 KB

个人中心 API 接口文档 (pages/my)

1. 获取个人中心数据概览

  • 接口说明: 进入“我的”页面时,获取用户个人资料摘要及各个功能的计数。
  • 请求路径: /user/profile-summary
  • 请求方法: GET
  • 公共头部: Authorization: Bearer {Token}
  • 接口返回 JSON 数据:
字段名 类型 说明 示例值
code Number 状态码 200
data Object 概要数据 { ... }
data.user_info Object 用户基础资料 { "nickname": "岳大鹏", "avatar": "...", "school": "清华大学" }
data.has_online_resume Boolean 是否已启用在线简历 true
data.counts Object 各项业务计数 { "favorites": 5, "intentions": 2, "assessments": 3, "orders": 1 }

2. 附件简历管理

2.1 获取附件简历列表

  • 接口说明: 展示用户已上传的 PDF 简历文件列表。
  • 请求路径: /user/resumes
  • 请求方法: GET
  • 接口返回 JSON 数据:

    {
    "code": 200,
    "data": [
    { "id": 1, "name": "张三个人简历.pdf", "url": "https://...", "time": "2026-03-15" }
    ]
    }
    

2.2 关联上传的简历文件

  • 接口说明: 用户选择微信文件并上传到服务器后,将文件信息与用户账号关联。
  • 请求路径: /user/upload-resume
  • 请求方法: POST
  • 接口参数:
参数名 类型 必填 说明 示例值
name String 文件原始名称 "高级审计员简历.pdf"
url String 接口返回的永久访问 URL "https://api.shenjizhijia.com/resumes/xxx.pdf"

2.3 删除附件简历

  • 请求路径: /user/resumes/{id}
  • 请求方法: DELETE

3. 我的收藏列表

  • 接口说明: 获取用户收藏的所有岗位。
  • 请求路径: /jobs/favorites
  • 请求方法: GET
  • 接口参数: page, limit
  • 返回数据: 结构同 /jobs/list

4. 我的订单列表

  • 接口说明: 查看用户的所有支付历史(定金、测评费等)。
  • 请求路径: /order/list
  • 请求方法: GET
  • 接口返回 JSON 数据:
字段名 类型 说明 示例值
code Number 状态码 200
data Array 订单数组 [ ... ]
data[].order_no String 订单编号 "ORDER20260315"
data[].title String 支付项目名称 "审计员岗位定金"
data[].amount Number 支付金额 500.00
data[].status String 状态: paid (已支付), cancelled (已取消) "paid"
data[].time String 支付时间 "2026-03-15 10:30"

5. 获取我的 Offer 列表

  • 接口说明: 查看已发放的 Offer 及其状态。
  • 请求路径: /user/offers
  • 请求方法: GET
  • 接口返回 JSON 示例:

    {
    "code": 200,
    "data": [
    { "id": 1, "company": "华财仁合", "position": "高级审计", "status": "待签约" }
    ]
    }