31 KiB
出国申请管理 API 接口文档
📋 文档说明
适用场景
- 出国申请业务流程管理
- 出国申请审批流程控制
- 出国记录管理和跟踪
- 为 Cursor AI 提供完整的接口开发上下文
模块特色
- 完整审批流程:三级审批(部门主管→分管领导→校领导)
- 状态自动流转:申请提交→审批通过→自动创建记录
- 权限细分控制:申请、审批、记录管理分离
- 数据完整追踪:审批记录、状态变更历史完整保存
🔌 出国申请管理 API 接口文档
模块概述
模块名称:overseas / 出国申请管理
基础路径:/api/rs/overseas
版本:v1.0
负责人:weizzzz
更新时间:2025-01-28
模块功能
出国申请管理模块提供完整的出国申请业务流程管理功能,包括申请提交、多级审批、记录管理等核心功能。支持学术交流、培训学习、合作项目等多种出国目的,提供完整的审批流程控制和状态追踪。
权限说明
出国申请权限
- 权限前缀:
rs:overseas:application: - 权限列表:
rs:overseas:application:list- 查询申请列表权限rs:overseas:application:query- 查询申请详情权限rs:overseas:application:add- 新增申请权限rs:overseas:application:edit- 编辑申请权限rs:overseas:application:remove- 删除申请权限rs:overseas:application:export- 导出申请权限rs:overseas:application:submit- 提交申请权限rs:overseas:application:cancel- 取消申请权限rs:overseas:application:approve- 审批申请权限
出国记录权限
- 权限前缀:
rs:overseas:record: - 权限列表:
rs:overseas:record:list- 查询记录列表权限rs:overseas:record:query- 查询记录详情权限rs:overseas:record:add- 新增记录权限rs:overseas:record:edit- 编辑记录权限rs:overseas:record:remove- 删除记录权限rs:overseas:record:export- 导出记录权限rs:overseas:record:create- 创建记录权限rs:overseas:record:complete- 完成记录权限
出国审批权限
- 权限前缀:
rs:overseas:approval: - 权限列表:
rs:overseas:approval:list- 查询审批记录列表权限rs:overseas:approval:query- 查询审批记录详情权限rs:overseas:approval:export- 导出审批记录权限
📊 接口概览
接口分类
出国申请基础 CRUD 接口
| 接口名称 | HTTP 方法 | 路径 | 权限要求 | 功能描述 |
|---|---|---|---|---|
| 查询申请列表 | GET | /rs/overseas/application/list |
rs:overseas:application:list |
分页查询出国申请列表 |
| 查询申请详情 | GET | /rs/overseas/application/{id} |
rs:overseas:application:query |
根据ID查询出国申请详情 |
| 新增申请 | POST | /rs/overseas/application |
rs:overseas:application:add |
创建新的出国申请 |
| 修改申请 | PUT | /rs/overseas/application |
rs:overseas:application:edit |
更新出国申请信息 |
| 删除申请 | DELETE | /rs/overseas/application/{ids} |
rs:overseas:application:remove |
批量删除出国申请 |
| 导出申请 | POST | /rs/overseas/application/export |
rs:overseas:application:export |
导出出国申请数据 |
出国申请业务逻辑接口
| 接口名称 | HTTP 方法 | 路径 | 权限要求 | 功能描述 |
|---|---|---|---|---|
| 查询我的申请列表 | GET | /rs/overseas/application/my/list |
rs:overseas:application:list |
查询当前用户的申请列表(排除已通过的申请) |
| 查询待审批申请 | GET | /rs/overseas/application/pending/list |
rs:overseas:application:approve |
查询待当前用户审批的申请 |
| 按状态查询申请 | GET | /rs/overseas/application/status/{status} |
rs:overseas:application:list |
根据状态查询申请列表 |
| 提交申请 | PUT | /rs/overseas/application/submit/{id} |
rs:overseas:application:submit |
提交出国申请进入审批流程 |
| 重新提交申请 | PUT | /rs/overseas/application/resubmit/{id} |
rs:overseas:application:edit |
重新提交已拒绝的出国申请 |
| 取消申请 | PUT | /rs/overseas/application/cancel/{id} |
rs:overseas:application:cancel |
取消出国申请 |
| 审批申请 | POST | /rs/overseas/application/approve |
rs:overseas:application:approve |
审批出国申请(通过/拒绝) |
| 修复记录 | POST | /rs/overseas/application/fix/records |
rs:overseas:application:approve |
修复已审批通过但未创建记录的申请 |
出国记录管理接口
| 接口名称 | HTTP 方法 | 路径 | 权限要求 | 功能描述 |
|---|---|---|---|---|
| 查询记录列表 | GET | /rs/overseas/record/list |
rs:overseas:record:list |
分页查询出国记录列表 |
| 查询我的记录列表 | GET | /rs/overseas/record/my/list |
rs:overseas:record:list |
查询当前用户的记录列表 |
| 根据申请查询记录 | GET | /rs/overseas/record/application/{id} |
rs:overseas:record:query |
根据申请ID查询出国记录 |
| 查询记录详情 | GET | /rs/overseas/record/{id} |
rs:overseas:record:query |
根据ID查询出国记录详情 |
| 新增记录 | POST | /rs/overseas/record |
rs:overseas:record:add |
创建新的出国记录 |
| 修改记录 | PUT | /rs/overseas/record |
rs:overseas:record:edit |
更新出国记录信息 |
| 删除记录 | DELETE | /rs/overseas/record/{ids} |
rs:overseas:record:remove |
批量删除出国记录 |
| 导出记录 | POST | /rs/overseas/record/export |
rs:overseas:record:export |
导出出国记录数据 |
| 创建记录 | POST | /rs/overseas/record/create/{id} |
rs:overseas:record:create |
基于申请创建出国记录 |
| 更新完成状态 | PUT | /rs/overseas/record/complete |
rs:overseas:record:complete |
更新出国记录完成状态 |
出国审批记录接口
| 接口名称 | HTTP 方法 | 路径 | 权限要求 | 功能描述 |
|---|---|---|---|---|
| 查询审批记录列表 | GET | /rs/overseas/approval/list |
rs:overseas:approval:list |
分页查询审批记录列表 |
| 查询我的审批记录 | GET | /rs/overseas/approval/my/list |
rs:overseas:approval:list |
查询当前用户的审批记录 |
| 根据申请查询审批记录 | GET | /rs/overseas/approval/application/{id} |
rs:overseas:approval:query |
根据申请ID查询审批记录 |
| 查询审批记录详情 | GET | /rs/overseas/approval/{id} |
rs:overseas:approval:query |
根据ID查询审批记录详情 |
| 查询申请审批历史 | GET | /rs/overseas/application/approval/history/{id} |
rs:overseas:application:query |
查询指定申请的完整审批历史 |
| 导出审批记录 | POST | /rs/overseas/approval/export |
rs:overseas:approval:export |
导出审批记录数据 |
📄 数据结构定义
出国申请对象 (OverseasApplication)
interface OverseasApplicationVO {
applicationId: number | string; // 申请ID
applicantId: number; // 申请人ID
applicantName: string; // 申请人姓名
department: string; // 所属部门
position: string; // 职位
contactPhone: string; // 联系电话
contactEmail: string; // 联系邮箱
purpose: string; // 出国目的编码
purposeDetail: string; // 目的详细说明
destination: string; // 目的地国家
destinationCity: string; // 目的地城市
startDate: string; // 开始日期
endDate: string; // 结束日期
duration: number; // 出国天数
budget: number; // 预算金额
budgetSource: string; // 经费来源编码
invitation: string; // 邀请函信息
itinerary: string; // 行程安排
accommodationPlan: string; // 住宿安排
transportationPlan: string; // 交通安排
status: string; // 申请状态编码
currentApprover: string; // 当前审批人
approvalLevel: string; // 审批级别
applyTime: string; // 申请时间
approvalTime: string; // 审批完成时间
adminRemark: string; // 管理员备注
applicantRemark: string; // 申请人备注
createTime: string; // 创建时间
updateTime: string; // 更新时间
// 显示字段
statusText: string; // 状态文本
purposeText: string; // 目的文本
budgetSourceText: string; // 经费来源文本
approvalLevelText: string; // 审批级别文本
}
出国记录对象 (OverseasRecord)
interface OverseasRecordVO {
recordId: number | string; // 记录ID
applicationId: number; // 关联申请ID
applicantId: number; // 申请人ID
applicantName: string; // 申请人姓名
department: string; // 所属部门
purpose: string; // 出国目的
destination: string; // 目的地国家
actualStartDate: string; // 实际开始日期
actualEndDate: string; // 实际结束日期
actualDuration: number; // 实际出国天数
actualBudget: number; // 实际花费金额
completionStatus: string; // 完成状态编码
achievement: string; // 出国成果
reportContent: string; // 总结报告内容
certificatePath: string; // 证书文件路径
createTime: string; // 创建时间
updateTime: string; // 更新时间
// 显示字段
purposeText: string; // 目的文本
completionStatusText: string; // 完成状态文本
}
出国审批记录对象 (OverseasApproval)
interface OverseasApprovalVO {
approvalId: number | string; // 审批ID
applicationId: number; // 关联申请ID
approverId: number; // 审批人ID
approverName: string; // 审批人姓名
approvalLevel: string; // 审批级别编码
approvalStatus: string; // 审批状态编码
approvalOpinion: string; // 审批意见
approvalTime: string; // 审批时间
createTime: string; // 创建时间
updateTime: string; // 更新时间
// 显示字段
approvalLevelText: string; // 审批级别文本
approvalStatusText: string; // 审批状态文本
}
🔧 核心接口详细说明
1. 查询出国申请列表
接口地址:GET /rs/overseas/application/list
权限要求:rs:overseas:application:list
请求参数
interface OverseasApplicationQuery {
pageNum: number; // 页码(必须)
pageSize: number; // 每页大小(必须)
applicantName?: string; // 申请人姓名
department?: string; // 所属部门
purpose?: string; // 出国目的
destination?: string; // 目的地
status?: string; // 申请状态
approvalLevel?: string; // 审批级别
currentApprover?: string; // 当前审批人
applicantId?: number; // 申请人ID
budgetMin?: number; // 预算最小值
budgetMax?: number; // 预算最大值
applyTimeBegin?: string; // 申请开始时间
applyTimeEnd?: string; // 申请结束时间
startDateBegin?: string; // 出国开始日期范围
startDateEnd?: string; // 出国结束日期范围
}
响应示例
{
"code": 200,
"msg": "查询成功",
"rows": [
{
"applicationId": 1,
"applicantId": 1,
"applicantName": "张三",
"department": "计算机学院",
"position": "副教授",
"contactPhone": "13800138001",
"contactEmail": "zhangsan@example.com",
"purpose": "academic_exchange",
"purposeDetail": "参加国际人工智能学术交流会议,发表研究论文并进行学术交流",
"destination": "美国",
"destinationCity": "纽约",
"startDate": "2025-03-15",
"endDate": "2025-03-25",
"duration": 11,
"budget": 25000.00,
"budgetSource": "school",
"invitation": "已收到会议邀请函",
"itinerary": "3月15日飞往纽约,参加为期5天的会议,会后进行实验室访问",
"status": "1",
"currentApprover": "admin",
"approvalLevel": "2",
"applyTime": "2025-01-28 10:00:00",
"approvalTime": "2025-01-28 15:30:00",
"applicantRemark": "期待能够带回先进的研究成果",
"createTime": "2025-01-28 10:00:00",
"updateTime": "2025-01-28 15:30:00",
"statusText": "已通过",
"purposeText": "学术交流",
"budgetSourceText": "学校经费",
"approvalLevelText": "分管领导"
}
],
"total": 1
}
2. 新增出国申请
接口地址:POST /rs/overseas/application
权限要求:rs:overseas:application:add
请求参数
interface OverseasApplicationForm {
department: string; // 所属部门(必须)
position?: string; // 职位
contactPhone: string; // 联系电话(必须)
contactEmail: string; // 联系邮箱(必须)
purpose: string; // 出国目的(必须)
purposeDetail: string; // 目的详细说明(必须)
destination: string; // 目的地国家(必须)
destinationCity?: string; // 目的地城市
startDate: string; // 开始日期(必须)
endDate: string; // 结束日期(必须)
budget: number; // 预算金额(必须)
budgetSource: string; // 经费来源(必须)
invitation?: string; // 邀请函信息
itinerary: string; // 行程安排(必须)
accommodationPlan?: string; // 住宿安排
transportationPlan?: string; // 交通安排
applicantRemark?: string; // 申请人备注
}
请求示例
{
"department": "计算机学院",
"position": "副教授",
"contactPhone": "13800138001",
"contactEmail": "zhangsan@example.com",
"purpose": "academic_exchange",
"purposeDetail": "参加国际人工智能学术交流会议,发表研究论文并进行学术交流",
"destination": "美国",
"destinationCity": "纽约",
"startDate": "2025-03-15",
"endDate": "2025-03-25",
"budget": 25000.00,
"budgetSource": "school",
"invitation": "已收到会议邀请函",
"itinerary": "3月15日飞往纽约,参加为期5天的会议,会后进行实验室访问",
"accommodationPlan": "入住会议指定酒店",
"transportationPlan": "往返机票+当地交通",
"applicantRemark": "期待能够带回先进的研究成果"
}
响应示例
{
"code": 200,
"msg": "新增成功",
"data": null
}
3. 重新提交被拒绝的出国申请
接口地址: PUT /rs/overseas/application/resubmit/{id}
权限要求: rs:overseas:application:edit
功能说明: 允许用户重新提交已被拒绝的出国申请,支持修改申请内容后重新进入审批流程。
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | Long | 是 | 申请ID |
请求体:
{
"destination": "美国",
"purpose": "1",
"purposeDetail": "参加学术会议",
"destinationCity": "纽约",
"startDate": "2025-02-01",
"endDate": "2025-02-10",
"budget": 15000,
"budgetSource": "科研经费",
"itinerary": "详细行程安排",
"applicantRemark": "申请备注"
}
响应数据:
{
"code": 200,
"msg": "操作成功",
"data": null
}
业务逻辑:
- 只有状态为"已拒绝"(status=2)的申请才能重新提交
- 重新提交后状态重置为"待审核"(status=0)
- 自动重置审批级别和当前审批人信息
- 自动重新计算出国天数
- 更新申请时间为当前时间
4. 审批出国申请
接口地址:POST /rs/overseas/application/approve
权限要求:rs:overseas:application:approve
请求参数
interface ApprovalRequest {
applicationId: number | string; // 申请ID(必须)
approvalStatus: string; // 审批状态:1-通过,2-拒绝(必须)
approvalOpinion?: string; // 审批意见
}
请求示例
{
"applicationId": 1,
"approvalStatus": "1",
"approvalOpinion": "同意申请,项目具有重要学术价值,注意安全"
}
响应示例
{
"code": 200,
"msg": "审批成功",
"data": null
}
4. 修复已审批通过但未创建记录的申请
接口地址:POST /rs/overseas/application/fix/records
权限要求:rs:overseas:application:approve
功能说明
修复已审批通过但由于系统异常未自动创建出国记录的申请。该接口会:
- 查询所有状态为"已通过"的申请
- 检查是否存在对应的出国记录
- 为缺失记录的申请自动创建出国记录
请求参数
无需参数,直接POST请求即可。
请求示例
POST /rs/overseas/application/fix/records
Authorization: Bearer {token}
Content-Type: application/json
clientid: ruoyi-web
referer: http://localhost
响应示例
{
"code": 200,
"msg": "修复完成,共修复 3 条记录",
"data": "修复完成,共修复 3 条记录"
}
使用场景
- 系统升级后的数据修复
- 审批流程异常导致的记录缺失修复
- 管理员手动数据修复
5. 查询申请审批历史
接口地址:GET /rs/overseas/application/approval/history/{applicationId}
权限要求:rs:overseas:application:query
功能说明
查询指定出国申请的完整审批历史记录,按审批级别升序、审批时间降序排列。主要用于审批历史追溯和流程透明化。
路径参数
| 参数名 | 类型 | 必须 | 说明 |
|---|---|---|---|
| applicationId | number | 是 | 申请ID |
请求示例
GET /rs/overseas/application/approval/history/1
Authorization: Bearer {token}
Content-Type: application/json
clientid: ruoyi-web
referer: http://localhost
响应示例
{
"code": 200,
"msg": "查询成功",
"data": [
{
"approvalId": 1,
"applicationId": 1,
"approverId": 2,
"approverName": "李部长",
"approvalLevel": "1",
"approvalStatus": "1",
"approvalOpinion": "同意申请,项目具有重要学术价值",
"approvalTime": "2025-01-28 14:30:00",
"createTime": "2025-01-28 14:30:00",
"updateTime": "2025-01-28 14:30:00",
"approvalLevelText": "部门主管",
"approvalStatusText": "通过"
},
{
"approvalId": 2,
"applicationId": 1,
"approverId": 3,
"approverName": "王副校长",
"approvalLevel": "2",
"approvalStatus": "1",
"approvalOpinion": "项目符合学校发展战略,建议通过",
"approvalTime": "2025-01-28 16:15:00",
"createTime": "2025-01-28 16:15:00",
"updateTime": "2025-01-28 16:15:00",
"approvalLevelText": "分管领导",
"approvalStatusText": "通过"
},
{
"approvalId": 3,
"applicationId": 1,
"approverId": 4,
"approverName": "张校长",
"approvalLevel": "3",
"approvalStatus": "1",
"approvalOpinion": "同意出国,注意安全,及时汇报进展",
"approvalTime": "2025-01-28 17:45:00",
"createTime": "2025-01-28 17:45:00",
"updateTime": "2025-01-28 17:45:00",
"approvalLevelText": "校领导",
"approvalStatusText": "通过"
}
]
}
响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| approvalId | number | 审批记录ID |
| applicationId | number | 关联的申请ID |
| approverId | number | 审批人用户ID |
| approverName | string | 审批人姓名 |
| approvalLevel | string | 审批级别编码(1-部门主管,2-分管领导,3-校领导) |
| approvalStatus | string | 审批状态编码(0-待审核,1-通过,2-拒绝) |
| approvalOpinion | string | 审批意见 |
| approvalTime | string | 审批时间 |
| approvalLevelText | string | 审批级别中文描述 |
| approvalStatusText | string | 审批状态中文描述 |
特殊说明
- 返回数据按
approvalLevel升序、approvalTime降序排列 - 如果申请还未产生任何审批记录,返回空数组
- 只返回与指定申请ID相关的审批历史
- 审批历史记录一旦创建不可删除,确保流程可追溯
错误响应
{
"code": 500,
"msg": "申请ID不存在"
}
📝 字典码值说明
申请状态 (status)
| 编码 | 含义 | 描述 |
|---|---|---|
| 0 | 待审核 | 申请已提交,等待审批 |
| 1 | 已通过 | 申请审批通过 |
| 2 | 已拒绝 | 申请审批被拒绝 |
| 3 | 已取消 | 申请被申请人主动取消 |
| 4 | 已完成 | 出国活动已完成 |
出国目的 (purpose)
| 编码 | 含义 | 描述 |
|---|---|---|
| academic_exchange | 学术交流 | 参加学术交流活动 |
| conference | 学术会议 | 参加学术会议 |
| training | 培训学习 | 参加培训课程 |
| cooperation | 合作项目 | 开展合作研究项目 |
| research | 科研访问 | 科研访问学者 |
| other | 其他 | 其他出国目的 |
经费来源 (budgetSource)
| 编码 | 含义 | 描述 |
|---|---|---|
| school | 学校经费 | 学校提供经费支持 |
| government | 政府资助 | 政府资助项目 |
| project | 项目经费 | 科研项目经费 |
| self | 个人承担 | 个人承担费用 |
| cooperation | 合作单位 | 合作单位提供经费 |
| other | 其他 | 其他经费来源 |
审批级别 (approvalLevel)
| 编码 | 含义 | 描述 |
|---|---|---|
| 1 | 部门主管 | 第一级审批:部门主管 |
| 2 | 分管领导 | 第二级审批:分管领导 |
| 3 | 校领导 | 第三级审批:校领导 |
审批状态 (approvalStatus)
| 编码 | 含义 | 描述 |
|---|---|---|
| 0 | 待审核 | 等待审批 |
| 1 | 通过 | 审批通过 |
| 2 | 拒绝 | 审批拒绝 |
完成状态 (completionStatus)
⚠️ 重要说明:完成状态(completionStatus)与申请状态(status)是两个不同的概念!
- 申请状态(status):表示审批流程的状态(待审核/已通过/已拒绝)
- 完成状态(completionStatus):表示出国任务执行的状态(未完成/进行中/已完成/已取消)
| 编码 | 含义 | 描述 | 使用场景 |
|---|---|---|---|
| 0 | 未完成 | 出国活动尚未开始 | 已通过审批但尚未出发 |
| 1 | 进行中 | 出国活动正在进行 | 已出发但未返回(默认值) |
| 2 | 已完成 | 出国活动已完成 | 已返回并完成回执 |
| 3 | 已取消 | 出国活动取消 | 计划取消 |
字段关系示例:
- 出国记录中的申请若已通过审批(
status='1'),默认完成状态为"进行中"(completionStatus='1') - 出国记录列表显示"完成状态"字段,详情弹窗显示"申请状态"字段
- 所有出国记录的申请状态都应该是"已通过"(
status='1'),因为只有通过审批的申请才会出现在记录中
🔄 业务流程说明
申请流程
- 提交申请:用户填写申请信息并提交,状态为"待审核",审批级别为"部门主管"
- 部门主管审批:部门主管审批通过后,审批级别自动流转到"分管领导"
- 分管领导审批:分管领导审批通过后,审批级别自动流转到"校领导"
- 校领导审批:校领导审批通过后,申请状态变为"已通过",自动创建出国记录
- 完成出国:申请人完成出国活动后,更新记录状态为"已完成",申请状态同步更新
状态流转
草稿状态 → 待审核 → 已通过/已拒绝
↓
已取消
↓
已完成
权限控制
- 申请人:可以查看自己的申请,编辑草稿状态的申请,提交/取消申请
- 审批人:可以查看待审批的申请,进行审批操作
- 管理员:拥有所有权限,可以管理所有申请和记录
🧪 测试说明
测试环境
- 基础URL:
http://localhost:8080 - 认证方式:Bearer Token
- 必需Header:
Authorization: Bearer {token} Content-Type: application/json clientid: ruoyi-web referer: http://localhost
测试用例
- 申请管理测试:创建申请→提交申请→审批流程→状态验证
- 权限测试:不同角色的权限边界测试
- 业务流程测试:完整的申请到完成流程测试
- 数据校验测试:参数验证、业务规则验证
注意事项
- 测试前确保数据库表结构已创建
- 测试用户需要有相应的权限
- 审批测试需要使用不同级别的审批人账号
- 时间字段格式为:
YYYY-MM-DD HH:mm:ss
📝 更新记录
| 版本 | 更新时间 | 更新内容 | 更新人 |
|---|---|---|---|
| v1.0 | 2025-01-28 | 初始版本,包含完整的API接口文档 | weizzzz |
| v1.1 | 2025-08-03 | 新增查询申请审批历史接口,完善审批流程追溯功能 | weizzzz |
| v1.2 | 2025-01-09 | 新增修复记录接口,修复审批通过后记录创建问题 | weizzzz |
| v1.3 | 2025-01-08 | 调整我的申请列表接口,显示完整申请历史(包括已通过申请) | weizzzz |
| v1.4 | 2025-01-08 | 修正我的申请列表接口,排除已通过申请(已通过申请显示在出国记录中) | weizzzz |
| v1.5 | 2025-01-28 | 新增盖章文件上传功能,用户需上传盖章文件后才能提交申请 | weizzzz |
8. 上传登记备案表盖章文件
接口地址:POST /rs/overseas/application/uploadStampedFile
权限要求:rs:overseas:add
功能说明
用于上传填写并加盖公章后的登记备案表文件。支持PDF、JPG、PNG格式,文件大小不超过10MB。上传成功后,用户才能提交出国申请。
请求参数
Content-Type: multipart/form-data
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | File | 是 | 盖章文件,支持PDF、JPG、PNG格式 |
| applicationId | Long | 是 | 申请ID |
请求示例
POST /rs/overseas/application/uploadStampedFile
Content-Type: multipart/form-data
Authorization: Bearer {token}
clientid: ruoyi-web
referer: http://localhost
form-data:
file: [选择的盖章文件]
applicationId: 1
响应示例
成功响应:
{
"code": 200,
"msg": "盖章文件上传成功",
"data": {
"filePath": "overseas/stamped/stamped_1_1704076800000.pdf",
"fileName": "出国境登记表_张三.pdf",
"uploadTime": "2025-01-28 14:30:00"
}
}
失败响应:
{
"code": 500,
"msg": "不支持的文件格式,请上传PDF、JPG或PNG文件"
}
业务规则
- 文件格式:只支持PDF、JPG、PNG格式
- 文件大小:不超过10MB
- 数量限制:每个申请只能上传一个盖章文件
- 上传成功后,系统自动更新申请记录的盖章文件信息
- 必须先上传盖章文件,才能提交出国申请
数据库更新
上传成功后,系统会自动更新以下字段:
stamped_registration_file_path: 文件存储路径stamped_registration_file_name: 原始文件名stamped_file_upload_time: 上传时间stamped_file_upload_status: 上传状态(设为'1')
📞 技术支持:如有疑问请联系开发团队
📚 相关文档:参考项目API文档基础规范和开发规范