# OpenAPI definition

## API Docs
- 个人资料 [查询当前学生资料](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809490e0.md): 查询当前登录学生（仅 STUDENT 角色）自己的学生资料。身份仅从 JWT/SecurityContext 获取，不接受 userId、studentUserId 等请求参数；本接口无 Path、Query、Body 参数。若尚未创建个人资料：HTTP 200，data 为空对象 {}（非 null），且不会自动创建数据库记录。当前未设置接口级限流。
- 个人资料 [更新学生资料](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809491e0.md): 仅更新传入的非 null 字段；不存在则自动创建。已有在线简历时必须携带其最新 revision，缺少或过期返回409/6002；成功写入推进版本，须重新 GET 在线简历获取最新版本。尚无在线简历记录的旧客户端可省略 revision 或传0。
- 个人资料 [下载简历](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001080e0.md): 下载当前学生上传的简历文件，仅 STUDENT 角色
- 个人资料 [上传简历](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001081e0.md): 仅 STUDENT 角色；PDF/DOC/DOCX，≤10MB；上传新简历时替换旧文件
- 个人资料 [删除简历](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001082e0.md): 删除当前学生的简历文件并清空 resumeUrl，仅 STUDENT 角色
- 个人资料 [工作经历优化建议（真实模式仅开发合成联调）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759317e0.md): 仅STUDENT；mode=off/stub/deepseek，默认off，旧stub-enabled兼容；deepseek仅dev环境且配置完整才启用。真实返回simulated=false，不保存工作经历。
- 岗位 [查询已发布岗位列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809494e0.md): 仅返回 PUBLISHED 岗位，支持关键词、城市、用工类型、薪资筛选和分页
- 岗位 [创建岗位](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809495e0.md): 仅企业账号可调用，新岗位默认 DRAFT 状态。可选 mapLocation 保存岗位实际工作位置；缺省/null 为 UNSET，不推断企业注册地址。非 UNSET 必须具备实际工作地址、成对数字坐标及 GCJ02；位置参数非法返回 HTTP 400，业务校验为 1001。无高德密钥、图片或外部服务调用。
- 岗位 [岗位筛选选项](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786356e0.md): 返回当前 PUBLISHED 岗位可用的 cities、employmentTypes、salaryRange，以及 industries、experiences、educations 字符串数组。新增选项按实际数据去重排序、排除空值，不是固定枚举；不含仅草稿/关闭岗位的值；行业来自有已发布岗位的企业。选项值原样作为搜索标签，不发送不限。
- 岗位 [查询岗位详情（公开）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809497e0.md): 仅返回 PUBLISHED 岗位详情；CLOSED 也可查看详情
- 岗位 [岗位高级搜索](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786355e0.md): 仅返回 PUBLISHED 岗位，支持关键词、城市、用工类型、薪资、公司、行业、经验、学历筛选、排序和分页；industry/experience/education 逗号分隔多选，同维度 OR、跨维度 AND，trim 后忽略大小写精确匹配，空值不筛选；筛选选项见 /jobs/filters。每项原始参数最多4096字符。
- 岗位 [查询岗位详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809492e0.md): 企业可查看自己管理的岗位详情
- 岗位 [更新岗位](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809493e0.md): 仅岗位所属企业可修改，跨企业岗位保持 404。mapLocation 是可选整体替换；缺省/null 且城市与工作地址未变时保持原值；城市或地址改变但未重传点位时自动失效为 UNSET。显式 status=UNSET 清空位置；非 UNSET 必须提供成对数字坐标、GCJ02 和更新后非空地址，非法位置参数 HTTP 400，业务校验为 1001；失败不产生部分写入。
- 岗位 [发布/关闭岗位](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809496e0.md): DRAFT→PUBLISHED，PUBLISHED→CLOSED；禁止非法回退
- 岗位 [搜索岗位工作地点候选](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759316e0.md): 仅已建立企业资料的 COMPANY 账号。city 与 keyword 必填、去除首尾空白后分别 1—40、2—80 字符，不接受控制字符或竖线；非法参数 HTTP 400/1001（缺参数为 400/400）。返回最多 10 个 GCJ02 地点，不代表真实办公地址已经平台核验，也不写岗位。无结果为 items=[]。企业选择并确认后调用既有岗位创建/编辑接口保存 mapLocation 和 workLocation。HTTP 429/429 为企业每分钟或全局每小时额度耗尽，Retry-After=60；HTTP 503/9001 为未配置密钥、Redis 或上游不可用，不得当作空结果。缺企业资料沿用 404/5001，非企业 403/2002。
- 企业 [查询当前企业资料](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809498e0.md): 返回当前登录用户绑定的企业资料，未绑定企业返回 404
- 企业 [更新企业资料](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809499e0.md): 仅更新传入的非 null 字段；未绑定企业时返回 404
- 企业 [创建企业资料](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809500e0.md): 仅 COMPANY 角色可调用；已存在时返回 409
- 企业 [查询企业公开详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786359e0.md): 匿名可访问，仅返回 6 个公开字段
- 企业 [查询企业公开岗位列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786360e0.md): 匿名可访问，仅返回 PUBLISHED 岗位
- 企业 [查询企业入驻状态](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518771093e0.md): 返回当前企业资料、认证状态和允许动作
- 企业 [查询当前企业岗位管理列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/524900213e0.md): 仅返回当前登录企业自己的岗位，可按状态、标题关键词和城市筛选；未认证企业可查看自己的岗位记录
- 认证 [手机号验证码登录](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809502e0.md): 手机号验证码登录；返回 passwordConfigured。无密码且密码功能开启时，login 短信验证成功还返回一次性的 passwordSetupToken 与 passwordSetupExpiresIn=600；设置成功替换 Token 后根据 identitySelectionRequired 选择身份。旧角色、验证码登录及成功码 200 保持不变。
- 认证 [当前用户信息](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809503e0.md): 需要 JWT 认证
- 认证 [刷新 Token](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518183989e0.md): 使用 Refresh Token 换取新的 Access/Refresh Token 对；旧 Refresh Token 立即失效
- 认证 [发送短信验证码](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809501e0.md): 真实发送使用阿里云短信网关；Mock 仅供开发测试。网关受理不等于手机送达，验证码不会写入日志。
- 认证 [登出](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518183990e0.md): 撤销当前登录会话；需要 Access Token，不接受任何请求体
- 认证 [首次设置密码](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518183991e0.md): 
- 认证 [短信找回并重置密码](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518183992e0.md): 
- 认证 [手机号密码登录](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518183993e0.md): 使用手机号和密码登录，返回 Access/Refresh Token；不自动创建账号
- 认证 [修改密码](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518183994e0.md): 
- 认证 [企业注册](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518771092e0.md): 使用 company-register 短信验证码创建企业账号和企业资料
- 认证 [首次选择账号身份](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/520663107e0.md): 统一账号一次性选择 STUDENT 或 COMPANY；COMPANY 必须提交 company 资料且注册开关开启。首次成功撤销全部旧会话并返回新凭证；同身份重复请求只返回状态，不重复颁发凭证。
- 认证 [短信登录后首次设置密码](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/524900212e0.md): 必须携带当前 Access Token 与 login 登录返回的 10 分钟一次性 passwordSetupToken；成功后替换两枚 Token，验证码登录继续可用。
- 投递 [投递岗位](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809504e0.md): 只能投递 PUBLISHED 岗位；仅所有历史投递均已撤回时可重投。重投返回新 id、attemptNumber 和 previousApplicationId，不继承旧匹配或授权；进行中、已拒绝、已录用仍返回重复投递错误。
- 投递 [我的投递列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809508e0.md): 查看当前学生自己的投递记录，支持 status 筛选和分页；附当前岗位摘要 jobTitle/companyId/companyName/city/salaryMin/salaryMax/jobStatus/employmentType，薪资单位元/月
- 投递 [投递详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809507e0.md): 查看自己的投递记录详情
- 投递 [更新投递状态（企业）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809505e0.md): SUBMITTED→VIEWED→INTERVIEW→REJECTED/HIRED
- 投递 [投递状态时间线](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001084e0.md): 学生本人或岗位所属企业可查看状态变更历史
- 投递 [撤回投递](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001083e0.md): 仅 SUBMITTED/VIEWED 可撤回；旧记录不恢复，可通过 POST /applications 创建新一轮投递。
- 投递 [查看岗位投递列表（企业）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809506e0.md): 企业查看自己发布的某个岗位收到的投递，支持 status 筛选和分页
- 投递 [企业候选人列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786361e0.md): 跨岗位查询本企业所有候选人投递，支持按岗位、状态、关键词筛选，支持分页和排序
- 投递 [企业候选人详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786362e0.md): 查看投递详情及候选人公开资料，只能查看本企业岗位下的投递
- 投递 [企业下载候选人简历](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/518183988e0.md): 按候选人隐私设置授权后返回简历文件流；不返回存储路径、学生 ID 或联系方式
- 投递 [企业接受投递并解锁沟通](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759315e0.md): 仅已认证的岗位所属企业；无请求体。SUBMITTED/VIEWED/INTERVIEW/HIRED 可接受，拒绝/撤回返回409。接受与招聘状态分离，不修改status、不填写双方评分；幂等返回原companyAcceptedAt。成功后双方可调用 POST /applications/{id}/conversation，无需双向评分达标。
- 系统 [应用健康检查](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809510e0.md): 返回应用及依赖服务状态
- 系统 [应用信息](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809509e0.md): 返回应用版本、运行时信息
- health-controller [healthDetails](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809511e0.md): 
- API [API 信息](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/497809512e0.md): 返回 API v0.1 基本信息
- 简历版本 [简历版本列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001088e0.md): 本人 ACTIVE 版本，version_no 倒序
- 简历版本 [创建简历版本](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001089e0.md): 仅本人(STUDENT)；PDF/DOC/DOCX ≤10MB；可附版本名
- 简历版本 [简历版本详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001085e0.md): 仅本人可查看；他人 403，不存在 404
- 简历版本 [修改简历版本](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001086e0.md): 本人；可选重命名 + 可选替换文件（替换时删除旧文件）
- 简历版本 [删除简历版本](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001087e0.md): 默认版本需先设其他默认；导出进行中不可删；删除文件并移除记录
- 简历版本 [设为默认简历](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001091e0.md): 同用户最多一个默认；已默认幂等；并发冲突 409
- 简历版本 [创建简历导出任务](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001090e0.md): 异步复制该版本文件到导出目录；返回任务状态
- 简历版本 [导出任务状态](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001092e0.md): 仅本人可查询；SUCCESS 含输出文件，FAILED 含失败原因
- 简历版本 [下载导出产物](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001093e0.md): 仅本人且任务 SUCCESS 可下载；attachment；不暴露内部路径
- 求职偏好 [查询求职偏好](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001094e0.md): 仅 STUDENT；无记录时返回空偏好对象
- 求职偏好 [保存求职偏好](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001095e0.md): 仅 STUDENT；upsert，非 null 字段部分更新，列表[]清空；薪资以元/月计，按与已存值合并后的区间校验。已有在线简历时必须携带其最新 revision，缺少或过期返回409/6002；成功写入推进版本，须重新 GET 在线简历获取最新版本。尚无在线简历记录时可省略 revision 或传0。
- Offer [Offer 列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001098e0.md): 候选人查看收到的、企业查看发出的 Offer；支持 status、applicationId 筛选与分页
- Offer [创建 Offer](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001099e0.md): 仅企业账号；投递存在、岗位属于本企业、投递状态可发、无有效 Offer；默认 DRAFT
- Offer [Offer 比较](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081779e0.md): 仅候选人本人；比较 2-5 个非 DRAFT 的 Offer
- Offer [Offer 统计](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081778e0.md): 仅企业；统计本企业 Offer 状态分布、接受率、平均响应时间
- Offer [Offer 详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001096e0.md): 仅目标候选人、所属企业可访问；其他账号返回无权限错误
- Offer [修改 Offer](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001097e0.md): 仅所属企业、仅 DRAFT 状态可修改；其余状态返回业务错误
- Offer [还价列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081774e0.md): 候选人查看本人 Offer 的还价、企业查看本企业 Offer 的还价
- Offer [发起还价](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081775e0.md): 仅候选人本人；仅 SENT/NEGOTIATING 可发起；SENT 时自动进入 NEGOTIATING
- Offer [接受还价](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081777e0.md): 仅所属企业；接受后更新 Offer 薪资/入职日期并变为 ACCEPTED
- Offer [拒绝还价](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081776e0.md): 仅所属企业；拒绝后 Offer 保持 NEGOTIATING
- Offer [手动提醒](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001100e0.md): 仅所属企业；仅 SENT/NEGOTIATING 可提醒；相同提醒不重复创建
- Offer [Offer 状态变更](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001101e0.md): DRAFT→SENT 企业；SENT/NEGOTIATING→ACCEPTED/REJECTED/NEGOTIATING 候选人；重复提交幂等
- Offer [Offer 状态时间线](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001102e0.md): 完整状态变更历史，含操作者、原因与请求 ID
- 岗位评价 [岗位对比](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786358e0.md): 公开访问；ids 为 2-3 个公开岗位；返回公开岗位字段与公开评分
- 岗位评价 [查询岗位评价列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001105e0.md): 公开访问；仅返回 PUBLISHED 评价，分页；每条含八维评分
- 岗位评价 [创建岗位评价](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001106e0.md): 仅 STUDENT；同一学生对同一岗位只能评价一次
- 岗位评价 [评分汇总](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001107e0.md): 公开访问；统计 PUBLISHED 评价的平均分、分布和热门标签
- 岗位评价 [岗位评价详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786357e0.md): 公开访问；返回单条 PUBLISHED 评价与八维评分
- 岗位评价 [修改评价](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001103e0.md): 仅评价本人可以修改
- 岗位评价 [删除评价](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001104e0.md): 仅评价本人可以删除
- 候选人反馈 [查询候选人反馈](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001108e0.md): 该投递的企业或学生可查看
- 候选人反馈 [修改候选人反馈](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001109e0.md): 仅岗位所属企业
- 候选人反馈 [创建候选人反馈](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001110e0.md): 仅岗位所属企业；同一投递只能反馈一次
- 候选人反馈 [删除候选人反馈](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001111e0.md): 仅岗位所属企业
- 通知 [通知列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001114e0.md): 当前用户的通知，分页，按时间倒序
- 通知 [全部已读](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001113e0.md): 标记当前用户全部通知已读（幂等）
- 通知 [未读数](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001115e0.md): 当前用户未读通知数
- 通知 [标记已读](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001112e0.md): 标记单条通知已读（幂等）
- 岗位收藏 [我的收藏列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001118e0.md): 仅 STUDENT；分页，按收藏时间倒序
- 岗位收藏 [收藏岗位](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001116e0.md): 仅 STUDENT；仅 PUBLISHED；幂等
- 岗位收藏 [取消收藏](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001117e0.md): 仅 STUDENT；幂等，未收藏也返回 200
- 消息 [会话列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001119e0.md): 当前用户参与的所有会话
- 消息 [创建/获取会话](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001120e0.md): 创建或返回与另一用户的 DIRECT 会话
- 消息 [发送消息](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001122e0.md): 在会话中发送消息，仅成员可发送
- 消息 [会话详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001123e0.md): 查看会话信息和未读数
- 消息 [消息列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001124e0.md): 分页查询会话消息，倒序；仅成员可查看
- 消息 [标记已读](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001121e0.md): 将当前会话所有消息标记为已读
- 消息 [撤回消息](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/513456808e0.md): 仅原发送者可在发送后两分钟内撤回消息；重复撤回幂等返回当前状态
- 消息 [补拉会话事件](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/524900214e0.md): 按持久化游标恢复新消息、已读、撤回；仅当前会话成员
- 消息 [发送固定版本简历卡片](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759308e0.md): 仅投递本人，双方为会话成员且企业已接受投递；兼容历史 MATCHED/HIRED。拒绝/撤回、屏蔽、企业认证和简历隐私规则仍生效。clientMessageId 必填，重试复用原值
- 消息 [授权下载简历快照](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759309e0.md): 每次校验成员、投递归属、认证、匹配、隐私、屏蔽及撤回状态，不返回公开文件地址
- 消息 [撤销简历卡片授权](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759310e0.md): 仅原发送者，幂等，销毁快照字节并推送 RESUME_REVOKED；不受两分钟文本撤回窗口限制
- 消息 [上传并发送图片或文件消息](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759311e0.md): 仅有当前沟通权限的 DIRECT 成员。multipart 字段 file、kind=IMAGE/FILE、clientMessageId 必填；同一重试必须保持三者不变。单文件 10 MiB；IMAGE 支持 JPEG/PNG、最多 1600 万像素且边长≤8192，去除元数据并生成最长边320的JPEG缩略图；FILE支持 PDF/DOC/DOCX/UTF-8 TXT。默认会话有效附件总量100 MiB。成功原子提交消息与字节，复用 MESSAGE_CREATED 推送和游标补拉；不返回公开URL。
- 消息 [鉴权下载消息附件](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759312e0.md): 每次重新校验成员、企业认证、有效投递和屏蔽，撤回或发送者禁用后不可下载；返回 no-store/nosniff/attachment，不支持公开URL或Token查询参数。
- 消息 [鉴权读取图片缩略图](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759313e0.md): 仅IMAGE，最长边320的JPEG，鉴权与下载相同。
- 消息 [鉴权读取图片预览](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759314e0.md): 仅IMAGE，返回已重新编码去除元数据的图片；鉴权与下载相同。
- 岗位匹配 [岗位匹配诊断](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/500001125e0.md): 仅 STUDENT；返回匹配分、硬性条件、缺口和说明
- student-review-weight-controller [getPersonalizedScore](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786366e0.md): 
- student-review-weight-controller [getMyWeights](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786363e0.md): 
- student-review-weight-controller [saveWeights](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786364e0.md): 
- student-review-weight-controller [getTemplates](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786365e0.md): 
- 双向匹配阈值 [查询企业匹配阈值](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786369e0.md): 未配置返回默认 60
- 双向匹配阈值 [更新企业匹配阈值](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786370e0.md): requiredCandidateScore 0-100；首次更新创建配置
- 双向匹配阈值 [查询学生匹配阈值](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786367e0.md): 未配置返回默认 60
- 双向匹配阈值 [更新学生匹配阈值](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786368e0.md): requiredHrScore 0-100；首次更新创建配置
- 面试 [查询投递的面试列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786376e0.md): 学生本人或岗位所属企业可查看
- 面试 [创建面试邀请](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786377e0.md): 企业为投递记录创建面试邀请
- 面试 [我的面试列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786379e0.md): 查看当前用户相关的面试，支持 status/from/to 筛选和分页
- 面试 [面试详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786371e0.md): 学生本人或企业可查看面试详情
- 面试 [修改面试](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786372e0.md): 企业修改面试时间、地点等信息，仅 SCHEDULED/CONFIRMED 状态可修改
- 面试 [取消面试](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786375e0.md): 企业取消已安排的面试
- 面试 [完成面试](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786374e0.md): 企业在面试时间结束后将面试标记为完成
- 面试 [响应面试邀请](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786373e0.md): 学生接受、拒绝或申请改期
- 面试 [面试状态时间线](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786378e0.md): 查看面试状态变更历史
- 双向匹配 [提交求职者岗位意愿分](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786381e0.md): 仅投递本人(STUDENT)；0-100；MATCHED/CLOSED 后不可修改
- 双向匹配 [提交企业 HR 适配分](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786380e0.md): 仅岗位所属企业；0-100；MATCHED/CLOSED 后不可修改
- 双向匹配 [查询投递匹配状态](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786382e0.md): 仅投递求职者或岗位所属企业；不暴露内部路径/事件 ID。附 companyAcceptedAt（明确接受时间，可null）和 communicationAllowed（沟通资格）；接受后不要求双向评分达标。匹配 status=CLOSED 可能由 HIRED 引起，不代表 communicationAllowed=false；最终仍校验会话归属、企业认证与屏蔽。
- 企业认证 [待审核认证列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786386e0.md): 管理员查看认证申请列表，支持 status/from/to 筛选和分页
- 企业认证 [认证审核历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786388e0.md): 管理员查看某个认证申请的审核历史
- 企业认证 [认证详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786387e0.md): 管理员查看认证申请详情
- 企业认证 [审核决定](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786385e0.md): 管理员通过或拒绝认证申请，拒绝时必须填写原因
- 企业认证 [查询企业认证状态](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786383e0.md): 企业查询自己的认证状态和历史
- 企业认证 [提交企业认证](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786384e0.md): 企业提交认证材料（营业执照等），只能提交自己的认证
- 双向匹配沟通 [创建/获取投递沟通会话](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786389e0.md): 仅投递双方；企业接受后即可沟通，无需双向评分达标；历史 MATCHED 或 HIRED 保持兼容。已拒绝/撤回投递返回409/8304，未接受同样返回409/8304；重复调用返回同一会话。企业认证、归属、屏蔽校验保留。GET /applications/{id}/match 的 communicationAllowed 为沟通资格，不应从匹配 status=CLOSED 推断禁止沟通。
- 评价审核 [待审评价列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786391e0.md): 仅 ADMIN；分页 + jobId/riskLevel/createdFrom/createdTo 筛选；不返回明文 IP/UA
- 评价审核 [评价审核决策](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786390e0.md): 仅 ADMIN；仅 PENDING 可审，重复提交 409；决策写入历史与 audit_logs
- 评价审核 [审核历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786392e0.md): 仅 ADMIN；分页返回审核结果、审核人、时间与原因
- 评价审核 [企业回复审核决策](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/511008524e0.md): 仅 ADMIN；仅 PENDING 可审，重复提交 409
- 评价审核 [待审企业回复列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/511008525e0.md): 仅 ADMIN；分页 + 企业/岗位/回复状态/创建时间范围筛选；moderationStatus 缺省为 PENDING
- 求职者评分卡 [查询百分位](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786395e0.md): 仅 STUDENT；返回自己在候选人中的评分百分位
- 求职者评分卡 [查询求职者评分卡](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786393e0.md): 仅 STUDENT；返回自己的评价聚合卡
- 求职者评分卡 [查询评分趋势](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786394e0.md): 仅 STUDENT；返回最近月份的反馈趋势
- 求职者评分体系 [企业候选人评分卡](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786399e0.md): 仅岗位所属企业；只读，仅返回 applicationId/overallScore/status/dimensions/generatedAt/rulesVersion，不泄露候选人敏感信息
- 求职者评分体系 [综合评分卡](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786396e0.md): 仅 STUDENT；返回本人 8 维评分、综合分、权重与状态
- 求职者评分体系 [单维度明细](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786397e0.md): 仅 STUDENT；返回某维度分项、归因与数据源；非法 dimension 返回 400
- 求职者评分体系 [评分趋势](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/503786398e0.md): 仅 STUDENT；基于快照按月返回综合分与维度分（months 1-24）
- 评分治理 [全部申诉列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081787e0.md): 仅 ADMIN
- 评分治理 [审核决定](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081784e0.md): 仅 ADMIN；APPROVE/REJECT，REJECT 必须填 reason
- 评分治理 [申诉历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081788e0.md): 本人（脱敏，无 actorUserId）或 ADMIN（全量）；此路径的本人放行先于 ADMIN 通用规则
- 评分治理 [执行回滚](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081783e0.md): 仅 ADMIN；记录前态+确定性重算+新版本；年 3 次上限
- 评分治理 [快照变更审计](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081786e0.md): 仅 ADMIN；按学生+维度+周期查看回滚前后完整变化
- 评分治理 [我的申诉列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081780e0.md): 仅 STUDENT 本人
- 评分治理 [提交评分申诉](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081781e0.md): 仅 STUDENT 本人；同一学生+维度+周期 PENDING/APPROVED 唯一
- 评分治理 [申诉详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081785e0.md): 本人或 ADMIN
- 评分治理 [撤销申诉](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081782e0.md): 仅本人；仅 PENDING 可撤销
- 评分运营看板 [全局运营概览](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081795e0.md): 仅 ADMIN
- 评分运营看板 [候选人评分排名](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081793e0.md): 仅 COMPANY；按学生去重；overallScore DESC, applicationId DESC
- 评分运营看板 [单候选人评分排名明细](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081794e0.md): 仅 COMPANY；跨企业 403/8004
- 评分运营看板 [岗位评分排名](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081791e0.md): 仅 COMPANY；avgRating DESC, jobId DESC；审核通过评价
- 评分运营看板 [单岗位评分排名](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081792e0.md): 仅 COMPANY；跨企业 403/8004
- 评分运营看板 [企业评分运营概览](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081790e0.md): 仅 COMPANY；只返回本企业数据
- 评分运营看板 [企业评分趋势](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/505081789e0.md): 仅 COMPANY；months 1–24
- 评分运营看板 [企业回复率统计](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/511622124e0.md): 仅企业；返回本公司本月回复率、行业平均回复率、本月待回复条数
- 账号 [查询注销状态](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/506906638e0.md): 查询注销状态
- 账号 [注销账号](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507002556e0.md): 注销账号
- 同岗位竞争力排名 [同岗位竞争力排名](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413770e0.md): 仅 STUDENT 且已投递该（PUBLISHED）岗位的学生可查看。返回本人排名/综合分/百分位/维度/缺口及匿名 Top 5。COMPANY/ADMIN 或未投递学生返回 403；岗位不存在或非 PUBLISHED 返回 404。身份仅取自 JWT，不接收 userId/studentUserId/candidateId 参数。topCandidates 每项仅含 rank 与 overallScore，不含任何身份字段（studentUserId/candidateId/name/school/phone/email/resumeUrl/applicationId）。cohort 排除 WITHDRAWN/REJECTED 投递。
- 求职进度 [统一求职进度聚合](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413771e0.md): 只读学生端接口：汇总当前学生的投递分页、岗位摘要、下一场面试、最近已提交结构化面试评分、可展示 Offer、同岗位竞争力排名，以及待办/通知计数（仅计数，不含通知标题/正文/详情）。仅 STUDENT 可访问，身份仅从 JWT/SecurityContext 获取，不接受 userId/studentUserId/candidateId 参数；COMPANY/ADMIN 返回 403/2002，未登录返回 401，参数非法返回 400/1001。通知详情仍由既有 /notifications 提供。
- account-deletion-controller [getStatus](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413772e0.md): 
- account-deletion-controller [initiate](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413773e0.md): 
- account-deletion-controller [cancelAccountDeletion](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413774e0.md): 
- personal-data-export-controller [查询个人数据导出任务列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413775e0.md): 仅本人；按创建时间倒序分页；status 可选：PENDING/PROCESSING/COMPLETED/FAILED/EXPIRED/CANCELLED
- personal-data-export-controller [创建个人数据导出任务](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413776e0.md): 异步生成 ZIP；同 idempotencyKey 重放返回原任务；注销 PENDING/COMPLETED 禁止创建
- personal-data-export-controller [查询个人数据导出任务详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413777e0.md): 仅本人；不暴露 storageKey 与内部字段
- personal-data-export-controller [下载个人数据导出 ZIP](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413778e0.md): 仅本人且 COMPLETED 未过期；attachment；需 JWT
- 结构化面试评分 [保存评分草稿](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413781e0.md): 企业 owner 为已完成的面试保存/更新草稿；草稿阶段五个维度可为空；overallScore 由服务端计算；SUBMITTED 后再次 PUT 返回 409/9503
- 结构化面试评分 [查看评分](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413782e0.md): 企业 owner 可看 DRAFT/SUBMITTED；目标学生仅可看 SUBMITTED；无评分返回 404/9504
- 结构化面试评分 [提交评分](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413783e0.md): 将 DRAFT 提交为 SUBMITTED，提交后不可逆；并发冲突 409；重复提交幂等返回原评分
- 结构化面试评分 [评分历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413784e0.md): 企业 owner 可查看全部历史；目标学生仅在 SUBMITTED 后可见；无历史返回 200 空数组；不返回内部用户标识
- 举报与屏蔽 [提交举报](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413785e0.md): targetType=USER 必填 targetUserId；MESSAGE 必填 messageId；reportedUserId 由服务端推导。同 reporter+idempotencyKey+相同请求体返回原举报 200；不同请求体 409/9606；同目标同分类已有 PENDING 409/9603。限流：每用户每小时 10 次，超限 429/9609。
- 举报与屏蔽 [我的举报列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413786e0.md): 仅返回当前用户创建的举报；身份来自 JWT；不返回举报人内部信息/phone/email/passwordHash/resumeUrl/消息全文；支持 status/page/size。
- 举报与屏蔽 [举报详情（本人/ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413787e0.md): 当前举报人本人或 ADMIN 可查看；其他 403/2002；非 ADMIN 不显示举报人内部 ID/手机号/邮箱；MESSAGE 仅返回脱敏 messagePreview。
- 举报与屏蔽 [屏蔽用户](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413788e0.md): 屏蔽自己 400/9608；目标不存在复用用户不存在错误码；已存在返回 200 不新增；不影响系统通知/投递/Offer/面试/评分/评价。
- 举报与屏蔽 [解除屏蔽](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413789e0.md): 幂等：不存在时返回 200 不报错。
- 举报与屏蔽 [我的屏蔽列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413790e0.md): 仅返回当前用户主动屏蔽的用户；不返回对方手机号/邮箱/密码/简历地址；支持 page/size。
- 举报管理 [举报列表（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413791e0.md): 仅 ADMIN；COMPANY/STUDENT/未登录分别 403/403/401；支持 status/targetType/category/page/size；响应脱敏。
- 举报管理 [举报详情（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413792e0.md): 仅 ADMIN；可见类型/分类/理由/脱敏证据 URL/MESSAGE 脱敏内容/会话最小信息/处理历史；不返回密码/JWT/手机号/邮箱/resumeUrl。
- 举报管理 [举报处理决定（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413793e0.md): 仅 ADMIN；decision 仅 RESOLVED/REJECTED；REJECTED 必填 note；仅 PENDING 可处理，重复 409/9604，非法流转 409/9605；处理后发送一条 REPORT_DECISION 通知。
- 企业回复评价 [查询回复](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/511006647e0.md): 公开访问；回复所属企业可见任意状态，其他用户仅见已审核通过的回复
- 企业回复评价 [更新回复](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/511006648e0.md): 仅回复所属企业；更新后需重新审核
- 企业回复评价 [创建回复](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/511006649e0.md): 仅岗位所属企业；一条评价只能回复一次
- 企业回复评价 [删除回复](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/511006650e0.md): 仅回复所属企业
- RIASEC 职业兴趣测评 [测评类型列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510878e0.md): 返回全部 ACTIVE 测评定义。任意已登录用户可访问；未登录 401。
- RIASEC 职业兴趣测评 [题目列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510879e0.md): 返回指定测评的 ACTIVE 题目，隐藏维度/reverseScored/source/版本等内部字段。
- RIASEC 职业兴趣测评 [创建答卷](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510880e0.md): 照六维各抽 5 题共 30 道并持久化，刷新不重抽。幂等键重放返回原答卷；同键不同定义 409/9709；已有活跃答卷 409/9708。仅 STUDENT。
- RIASEC 职业兴趣测评 [答卷详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510881e0.md): 返回本次抽中的 30 道题（固定顺序）、已保存答案、进度与当前状态。仅本人可访问；非 STUDENT 403。
- RIASEC 职业兴趣测评 [保存答案](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510882e0.md): 单题或批量保存，重复保存 upsert；value 1-5；题目必须属于本答卷；版本冲突 409/9707；首次保存后状态置为 IN_PROGRESS。仅本人。
- RIASEC 职业兴趣测评 [提交答卷](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510883e0.md): 30 题全答且每维各 5 题后方可提交（否则 400/9706）；提交后生成结果并写审计；重复提交返回原结果，不重复生成与审计。仅本人。
- RIASEC 职业兴趣测评 [查看结果](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510884e0.md): 答卷 COMPLETED 后返回聚合分、类型排名、探索方向。仅本人可访问。
- RIASEC 职业兴趣测评 [我的测评历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510885e0.md): 分页返回当前学生的全部答卷与结果概要。仅 STUDENT 本人可访问。
- privacy-settings-controller [getMyPrivacySettings](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413779e0.md): 
- privacy-settings-controller [updateMyPrivacySettings](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/507413780e0.md): 
- 四维能力测评 [能力测评类型列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510886e0.md): 
- 四维能力测评 [创建能力测评答卷](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510887e0.md): 
- 四维能力测评 [getAbilityAttempt](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510888e0.md): 
- 四维能力测评 [saveAbilityAnswers](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510889e0.md): 
- 四维能力测评 [submitAbilityAttempt](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510890e0.md): 
- 四维能力测评 [getAbilityResult](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510891e0.md): 
- 四维能力测评 [我的能力测评历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510892e0.md): 
- 风险治理 [风险概览（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510893e0.md): 
- 风险治理 [风险趋势（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510894e0.md): 
- 风险治理 [风险分布（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510895e0.md): 
- 风险治理 [风险事件分页（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510896e0.md): 
- 风险治理 [风险规则列表（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510897e0.md): 
- 风险治理 [更新风险规则（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510898e0.md): 
- 风险治理 [风险事件人工操作（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510899e0.md): 
- 岗位推荐 [recommendationTaxonomies](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510900e0.md): 
- 岗位推荐 [myJobRecommendations](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510901e0.md): 
- 岗位推荐 [createRecommendationFeedback](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510902e0.md): 
- 岗位推荐 [revokeNotInterestedFeedback](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510903e0.md): 
- 岗位推荐 [companyRecommendationProfile](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510904e0.md): 
- 岗位推荐 [updateCompanyRecommendationProfile](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510905e0.md): 
- 岗位推荐 [adminRecommendationProfiles](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510906e0.md): 
- 岗位推荐 [decideRecommendationProfile](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510907e0.md): 
- 企业评价管理 [listCompanyJobReviews](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510908e0.md): 
- 企业评价管理 [getCompanyJobReview](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510909e0.md): 
- 企业评价管理 [createCompanyReviewReply](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510910e0.md): 
- 企业评价管理 [reviseCompanyReviewReply](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510911e0.md): 
- 官方回复审核 [listPendingReviewReplies](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510912e0.md): 
- 官方回复审核 [decideReviewReply](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510913e0.md): 
- 企业人才发现 [查询人才发现授权](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510914e0.md): 
- 企业人才发现 [更新人才发现授权](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510915e0.md): 
- 企业人才发现 [查询岗位人才发现推荐](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510916e0.md): 
- 企业人才邀约 [创建人才邀约](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510917e0.md): 
- 企业人才邀约 [企业邀约列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510918e0.md): 
- 企业人才邀约 [企业邀约详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510919e0.md): 
- 企业人才邀约 [学生收到的邀约列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510920e0.md): 
- 企业人才邀约 [学生邀约详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510921e0.md): 
- 企业人才邀约 [处理人才邀约](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510922e0.md): 
- 行业技能词云 [查询个人技能匹配度](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/515276699e0.md): 使用 JWT 对应学生的 skills_json，与当前筛选结果 TOP10 比对；matchScore=round(matchedCount*100/min(10,total))。仅 STUDENT 可访问。
- 行业技能词云 [生成个人学习路径](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/515276700e0.md): 只针对个人 TOP10 中未命中的技能，沿用热度顺序返回连续 priority 和确定性通用建议；不调用 AI，不返回课程链接、时长或进度。仅 STUDENT 可访问。
- 行业技能词云 [查询行业技能词云](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/515276698e0.md): 返回筛选范围内的全部技能，按 heat DESC, nameZh ASC, skillId ASC 排序，heat=null 最后；前端取前十条作为 TOP10。仅 STUDENT 可访问。
- 公司知识介绍 [读取公司知识介绍](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284348e0.md): STUDENT 读取企业基础资料、企业维护内容和公开评价摘要；企业未配置知识时回退基础资料，公开评价少于 3 条时不返回均值。
- 公司知识介绍 [读取本企业知识配置](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284346e0.md): 返回当前 COMPANY 所属企业的知识配置；尚未配置时 configured=false、version=0。
- 公司知识介绍 [创建或更新本企业知识配置](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284347e0.md): 首次创建可省略 version；已有配置必须提交当前 version。字段按纯文本保存且禁止 HTML 标签。
- 入职清单 [更新本企业自定义清单项](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284349e0.md): 使用当前 version 更新本企业条目；版本过期返回 10502，不静默覆盖。
- 入职清单 [软删除本企业自定义清单项](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284350e0.md): 使用当前 version 将 active 置为 false；重复删除保持幂等成功。
- 入职清单 [读取有效入职清单](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284354e0.md): STUDENT 读取通用活动项与当前企业活动自定义项的合并清单；无企业自定义项时回退通用清单。
- 入职清单 [查询本企业自定义清单项](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284352e0.md): 返回当前 COMPANY 所属企业的活动与软删除自定义项，不包含通用项和其他企业项。
- 入职清单 [创建本企业自定义清单项](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284353e0.md): 为当前 COMPANY 所属企业创建自定义项；idempotencyKey 用于网络重试，活动项累计不超过 50 条。
- 入职清单 [更新清单条目完成状态](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/516284351e0.md): STUDENT 使用绝对 completed 状态更新本人进度；已有进度变化时必须提交当前 version，首次创建只接受 version=0 或空。
- 薪资计算器 [查询城市默认参数](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/517778948e0.md): 仅 STUDENT；未发布或未启用政策返回 404/10601，不返回参数
- 薪资计算器 [查询启用城市列表](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/517778947e0.md): 仅 STUDENT；仅返回已核验发布白名单中的启用城市版本；默认空列表，不分页
- 薪资计算器 [查询本人薪资历史详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/517778949e0.md): 
- 薪资计算器 [删除本人薪资历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/517778950e0.md): 
- 薪资计算器 [计算并保存到手工资](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/517778946e0.md): 仅 STUDENT；未发布政策返回 404/10601，幂等重放不可绕过发布门禁；本人历史查询不受影响
- 薪资计算器 [查询本人薪资历史](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/517778945e0.md): 
- 在线简历 [读取本人完整在线简历](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759318e0.md): 无保存记录时 revision=0，从已有资料、求职偏好和账号联系方式组装，不写库。attachment 仅返回文件元数据及鉴权下载地址。phone/email 为本人简历联系方式，不下发到企业候选人接口。
- 在线简历 [保存完整在线简历](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759319e0.md): 携带最近 GET 的 revision；content 完整替换，空数组删除该类全部条目，null/空字符串可清空可选字段。新条目省略 id，既有条目保留 id。成功 revision+1；过期 revision 返回409/6002。同步既有个人资料和求职偏好，不改登录手机号/邮箱、附件及隐私授权。
- 在线简历 [读取本人简历条目详情](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759320e0.md): 只在本人指定类别内寻找条目，不存在返回404/6003。
- 在线简历 [替换简历条目](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759321e0.md): entry 完整替换本人条目；id 可省略或须与 URL 一致；携带整份简历 revision。
- 在线简历 [删除简历条目](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759322e0.md): query revision 必填；不存在返回404/6003，过期版本返回409/6002；返回更新后的完整简历。
- 在线简历 [读取某类简历条目](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759323e0.md): section 仅 education-experiences/work-experiences/project-experiences/skills；revision 从整份简历 GET 获取。
- 在线简历 [新增简历条目](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759324e0.md): section 仅 education-experiences/work-experiences/project-experiences/skills；entry 为相应类型，新条目不传 id；携带整份简历 revision，返回更新后的完整简历。
- 在线简历 [下载在线简历 DOCX](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/528759325e0.md): 从当前已保存的在线内容生成 Word 文件，不含上传附件，不写文件、不创建附件版本；浏览器应携带鉴权获取 Blob，未保存编辑需先 PUT。
- [评分完整性概览（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510873e0.md): 
- [评分维度分布（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510874e0.md): 
- [评分历史漂移（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510875e0.md): 
- [排名稳定性（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510876e0.md): 
- [申诉纠错聚合（ADMIN）](https://s.apifox.cn/a64fdc2b-3980-4dc1-9b02-b1097417e76e/512510877e0.md):