sj-miniprogram/api_docs/jobs.md

岗位列表页 API 接口文档 (pages/jobs)

1. 获取岗位筛选列表

• 接口说明: 分页获取岗位列表，支持多种筛选条件，是 APP 的核心数据接口。
• 请求路径: /jobs/list
• 请求方法: GET
• 接口参数:

参数名	类型	必填	说明	示例值
category	Number	否	岗位大类: 0 (全职), 1 (实习), 2 (兼职)	0
keyword	String	否	搜索关键词 (匹配岗位名或公司名)	"审计"
sort	String	否	排序方式: comprehensive (综合), latest (最新)	"latest"
page	Number	否	页码 (默认1)	1
limit	Number	否	每页条数 (默认20)	20
min_salary	Number	否	最低薪资 (单位: K)	10
max_salary	Number	否	最高薪资 (单位: K)	30
education	String	否	学历要求	"本科"
experience	String	否	经验要求	"3-5年"

• 接口返回 JSON 数据:

字段名	类型	说明	示例值
code	Number	状态码	200
data	Object	分页包装对象	{ ... }
data.list	Array	岗位数组	[ ... ]
data.list[].id	Number	岗位 ID	101
data.list[].title	String	岗位名称	"审计项目经理"
data.list[].salary_text	String	薪资展示文本	"15K-20K"
data.list[].tags	Array	标签列表 (五险一金等)	["双休", "项目奖金"]
data.list[].is_urgent	Boolean	是否急招	true
data.list[].company_name	String	公司全名	"华财仁合会计师事务所"
data.list[].company_logo	String	公司 Logo URL	"https://..."
data.list[].location	String	工作地点	"上海·黄浦"
data.list[].deadline	String	截止日期	"2025-12-31"

• 接口示例:

  // 请求示例
  // GET /jobs/list?category=0&keyword=审计&page=1
  
  // 响应示例
  {
  "code": 200,
  "data": {
  "list": [
    {
      "id": 101,
      "title": "审计助理",
      "salary_text": "8K-12K",
      "tags": ["本科", "双休"],
      "is_urgent": true,
      "company_name": "华财仁合",
      "company_logo": "https://api.shenjizhijia.com/static/logo1.png",
      "location": "上海·黄浦",
      "deadline": "2025-12-30"
    }
  ],
  "total": 128
  }
  }
  

---

2. 提交岗位负反馈

• 接口说明: 当用户在列表中点击关闭按钮并选择“不喜欢”理由时，上报该行为以优化后续推荐算法。
• 请求路径: /jobs/feedback
• 请求方法: POST
• 接口参数:

参数名	类型	必填	说明	示例值
job_id	Number	是	岗位 ID	101
reason	String	是	反馈理由: 不喜欢工作单位, 岗位要求不匹配 等	"不喜欢工作单位"

• 接口返回 JSON 数据:

  {
  "code": 200,
  "msg": "我们将减少此类推荐",
  "data": {}
  }
  

---

3. 获取常用筛选配置项

• 接口说明: 获取筛选页面中，“学历”、“经验”等筛选条件的固定选项列表。
• 请求路径: /common/filter-options
• 请求方法: GET

• 接口返回 JSON 示例:

  {
  "code": 200,
  "data": {
  "education_options": ["不限", "大专", "本科", "硕士", "博士"],
  "experience_options": ["经验不限", "应届毕业生", "3年及以下", "3-5年", "5-10年", "10年以上"],
  "salary_range": { "min": 0, "max": 100 }
  }
  }