# 个人信息页 API 接口文档 (`pages/profile`) ## 1. 获取个人基本信息 * **接口说明**: 用于进入“填写个人信息”页面时,获取用户已保存的信息进行回显。 * **请求路径**: `/resume/profile` * **请求方法**: `GET` * **公共头部**: `Authorization: Bearer {Token}` * **接口参数**: 无 * **接口返回 JSON 数据**: | 字段名 | 类型 | 说明 | 示例值 | | :--- | :--- | :--- | :--- | | code | Number | 状态码 | 200 | | msg | String | 提示信息 | "获取成功" | | data | Object | 个人资料对象 | { ... } | | data.avatar | String | 头像图片 URL | "https://example.com/avatar.png" | | data.name | String | 真实姓名 | "岳大鹏" | | data.gender | String | 性别: `M` (男), `F` (女) | "M" | | data.id_card | String | 身份证号 | "110101XXXXXXXX1234" | | data.email | String | 电子邮箱 | "yue.dp@email.com" | * **接口示例**: ```json // 响应示例 { "code": 200, "msg": "获取成功", "data": { "avatar": "https://api.shenjizhijia.com/uploads/avatars/u10086.jpg", "name": "岳大鹏", "gender": "M", "id_card": "110101199608151234", "email": "yue.dp@email.com" } } ``` --- ## 2. 保存/更新个人信息 * **接口说明**: 在“填写个人信息”页面点击“完成”或“下一步”时,提交表单数据到后端保存。 * **请求路径**: `/resume/update-profile` * **请求方法**: `POST` * **公共头部**: `Authorization: Bearer {Token}` * **接口参数**: | 参数名 | 类型 | 必填 | 说明 | 示例值 | | :--- | :--- | :--- | :--- | :--- | | avatar | String | 否 | 头像 URL (通过上传接口获得) | "https://..." | | name | String | 是 | 真实姓名 | "岳大鹏" | | gender | String | 是 | 性别: `M` (男), `F` (女) | "F" | | id_card | String | 是 | 身份证号 | "110101..." | | email | String | 是 | 电子邮箱 | "yue.dp@email.com" | * **接口返回 JSON 数据**: | 字段名 | 类型 | 说明 | 示例值 | | :--- | :--- | :--- | :--- | | code | Number | 状态码 (200成功) | 200 | | msg | String | 提示信息 | "保存成功" | | data | Object | 通常返回已更新的数据或为空对象 | {} | * **接口示例**: ```json // 请求示例 { "avatar": "https://api.shenjizhijia.com/uploads/avatars/u10086.jpg", "name": "岳小妹", "gender": "F", "id_card": "110101199701018888", "email": "yue.xm@email.com" } // 响应示例 { "code": 200, "msg": "保存成功", "data": {} } ``` --- ## 3. 上传头像图片 * **接口说明**: 调用 `uni.chooseImage` 获取临时文件路径后,通过此接口上传到服务器并获取永久 URL。 * **请求路径**: `/common/upload` * **请求方法**: `POST` * **请求格式**: `multipart/form-data` * **公共头部**: `Authorization: Bearer {Token}` * **接口参数**: | 参数名 | 类型 | 必填 | 说明 | 示例值 | | :--- | :--- | :--- | :--- | :--- | | file | File | 是 | 图片文件对象 (二进制) | [File] | | type | String | 否 | 业务类型: `avatar` (头像), `resume` (简历附件) | "avatar" | * **接口返回 JSON 数据**: | 字段名 | 类型 | 说明 | 示例值 | | :--- | :--- | :--- | :--- | | code | Number | 状态码 | 200 | | msg | String | 提示信息 | "上传成功" | | data | Object | 包含文件 URL | { ... } | | data.url | String | 上传后的图片永久访问路径 | "https://api.shenjizhijia.com/uploads/avatars/abc123.jpg" | * **接口示例**: ```json // 响应示例 { "code": 200, "msg": "上传成功", "data": { "url": "https://api.shenjizhijia.com/uploads/avatars/abc123.jpg" } } ```