# 岗位列表页 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" |

*   **接口示例**:
```json
// 请求示例
// 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 数据**:
```json
{
  "code": 200,
  "msg": "我们将减少此类推荐",
  "data": {}
}
```

---

## 3. 获取常用筛选配置项

*   **接口说明**: 获取筛选页面中，“学历”、“经验”等筛选条件的固定选项列表。
*   **请求路径**: `/common/filter-options`
*   **请求方法**: `GET`
*   **接口返回 JSON 示例**:
```json
{
  "code": 200,
  "data": {
    "education_options": ["不限", "大专", "本科", "硕士", "博士"],
    "experience_options": ["经验不限", "应届毕业生", "3年及以下", "3-5年", "5-10年", "10年以上"],
    "salary_range": { "min": 0, "max": 100 }
  }
}
```