sj-miniprogram/api_docs/intention.md

工作意向页 API 接口文档 (pages/intention)

1. 获取求职意向详情

• 接口说明: 获取当前用户已设置的求职意向信息。
• 请求路径: /resume/intention
• 请求方法: GET
• 公共头部: Authorization: Bearer {Token}
• 接口返回 JSON 数据:

字段名	类型	说明	示例值
code	Number	状态码	200
msg	String	提示信息	"获取成功"
data	Object	意向数据详情	{ ... }
data.expect_jobs	Array	期望岗位关键词列表	["审计辅助", "财务分析"]
data.intern_duration	String	实习时长 (如果是实习)	"3个月"
data.arrival_time	String	最快到岗时间	"1周内"
data.job_types	Array	求职类型列表	["全职", "实习"]
data.target_companies	Array	意向公司列表 (包含 ID 和名称)	[{ "id": 1, "name": "普华永道" }]

---

2. 保存/更新求职意向

• 接口说明: 提交工作意向表单数据。
• 请求路径: /resume/update-intention
• 请求方法: POST
• 公共头部: Authorization: Bearer {Token}
• 接口参数:

参数名	类型	必填	说明	示例值
expect_jobs	Array	是	期望岗位名称列表	["审计助理"]
intern_duration	String	否	实习时长	"6个月"
arrival_time	String	是	到岗时间	"随时到岗"
job_types	Array	是	求职类型: 全职, 实习, 兼职	["全职"]
company_ids	Array	否	意向公司 ID 列表	[1, 2, 5]

• 接口示例:

  // 请求示例
  {
  "expect_jobs": ["审计助理", "内控合规"],
  "arrival_time": "2周内",
  "job_types": ["全职"],
  "company_ids": [101, 202]
  }
  

---

3. 获取公司搜索列表

• 接口说明: 在“公司列表”页面，根据用户输入的关键词搜索公司，用于添加意向公司。
• 请求路径: /common/company-list
• 请求方法: GET
• 接口参数:

参数名	类型	必填	说明	示例值
keyword	String	否	公司名称搜索关键词	"审计"
page	Number	否	页码	1
limit	Number	否	每页数量	20

• 接口返回 JSON 数据:

字段名	类型	说明	示例值
code	Number	状态码	200
data	Object	分页结果	{ ... }
data.list	Array	公司数组	[{ "id": 1, "name": "普华永道", "logo": "..." }]
data.total	Number	总记录数	150

• 接口示例:

  // 请求示例
  // GET /common/company-list?keyword=普华
  
  // 响应示例
  {
  "code": 200,
  "data": {
  "list": [
    {
      "id": 1,
      "name": "普华永道中天会计师事务所",
      "logo": "https://..."
    }
  ],
  "total": 1
  }
  }