shz-backend/docs/mobile-notice-settings-api.md

移动端消息接收设置接口

通用约定

• 基础地址：沿用移动端当前后端地址。
• 请求头：Authorization: Bearer <移动端求职者登录 Token>。
• 仅移动端求职者可调用；未携带或失效 Token 返回 HTTP 401，企业及其他角色返回业务码 403。
• 四个字段均为布尔值，true 表示接收该类消息，false 表示不接收。保存时必须一次传齐四项。

查看设置

GET /app/notice/settings

无需请求参数或请求体。首次查看（尚未保存过）会返回四项均开启的默认设置，且不会创建数据库记录。

成功响应示例：

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "jobUpdateEnabled": true,
    "appointmentReminderEnabled": true,
    "systemNotificationEnabled": true,
    "interviewNotificationEnabled": true
  }
}

字段说明：

字段	对应按钮
jobUpdateEnabled	职位上新
appointmentReminderEnabled	预约提醒
systemNotificationEnabled	系统通知
interviewNotificationEnabled	面试通知

保存设置

PUT /app/notice/settings

请求头 Content-Type: application/json，请求体示例：

{
  "jobUpdateEnabled": true,
  "appointmentReminderEnabled": false,
  "systemNotificationEnabled": true,
  "interviewNotificationEnabled": false
}

成功响应：

{
  "code": 200,
  "msg": "操作成功"
}

接口按登录 Token 自动识别当前用户，不接收也不允许客户端传入用户 ID。任一开关字段缺失或为 null 时，返回参数校验错误。