sj-miniprogram/api_docs/profile.md

个人信息页 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"

• 接口示例:

  // 响应示例
  {
  "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	通常返回已更新的数据或为空对象	{}

• 接口示例:

  // 请求示例
  {
  "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"

• 接口示例:

  // 响应示例
  {
  "code": 200,
  "msg": "上传成功",
  "data": {
  "url": "https://api.shenjizhijia.com/uploads/avatars/abc123.jpg"
  }
  }