# 工作意向页 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] |

*   **接口示例**:
```json
// 请求示例
{
  "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 |

*   **接口示例**:
```json
// 请求示例
// GET /common/company-list?keyword=普华

// 响应示例
{
  "code": 200,
  "data": {
    "list": [
      {
        "id": 1,
        "name": "普华永道中天会计师事务所",
        "logo": "https://..."
      }
    ],
    "total": 1
  }
}
```