提交审批

接口说明

提交一条审批申请。提交前需先通过审批模板列表选择模板，并确定目标设备。审批通过后，系统会依据模板类型自动为申请人授予对应的设备权限（查看 / 控制 / 视频）。

调用前提

提交审批需满足：已选择审批模板（template_id）+ 指定目标设备（device_id）+ 模板对应的权限类型。所选模板必须已配置至少一个可用审批节点，否则提交失败。

请求信息

项目	内容
方法	POST
路径	/api/approvals
服务	核心业务 API（域名见快速开始）
鉴权	是，请求头携带 Authorization: Bearer your_token_here

请求参数

请求体（JSON）：

参数名	类型	必填	说明
template_id	int	是	审批模板 ID，须为存在的模板
title	string	是	申请标题，最长 200 字符
device_id	int	是	目标设备 ID，须为存在的设备
content	string	否	申请说明
form_data	object	否	模板表单数据，例如权限时长 duration（1天 / 3天 / 7天 / 30天）或到期时间 end_time

请求示例

curl -X POST "/api/approvals" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "template_id": 3,
    "title": "申请控制 1 号巡检机器人",
    "device_id": 101,
    "content": "巡检任务需要临时控制权限",
    "form_data": { "duration": "7天" }
  }'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	响应描述
data.id	int	审批申请 ID
data.request_no	string	审批单号，格式 AP{yyyymmdd}{4位序号}

成功响应

{
  "code": 0,
  "message": "审批申请提交成功",
  "data": {
    "id": 1287,
    "request_no": "AP202607050001"
  }
}

失败响应

{
  "code": 422,
  "message": "当前审批模板未配置可用审批节点",
  "data": null
}

{
  "code": 422,
  "message": "模板不存在或已停用",
  "data": null
}