第三方平台应将监测的安全事件或安全隐患下发出的工单的数据通过工单归档接口向本级平台进行上报。
工单归档内容包括工单ID、录入方式、工单附件、审核方式、审核单位名称、审核通过时间、审核人、工单创建人、创建单位名称、反馈要求、所属区域、工单所属单位名称、事件来源、终审单位名称、终审通过时间、终审人、单位所属行业、发现厂商、超时情况、超时时间、签收人、签收时间、工单对象、工单编号、严重级别、工单主题、处置单位、处置人、处置完成时间、标签等。
请求地址:/open/api/v1/warn/add
接口类型:HTTP
请求方式:POST
请求参数:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 字段长度 | 必填/可选 | 说明 |
|---|---|---|---|---|---|---|
| 1 | user | 第三方系统用户名 | 文本 | 10 | 必填 | |
| 2 | timestamp | 请求发起时间戳 | 整数 | 64 | 必填 | |
| 3 | sign | md5(timestamp+user+token) | 字符 | 32 | 必填 | |
| 4 | dataValues | 对象数组 | 对象 | 必填 |
请求示例:
dataValues包含的字段:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 字段长度 | 必填/可选 | 说明 |
|---|---|---|---|---|---|---|
| 1 | authParam | 通用鉴权参数 | 通用鉴权参数«object,string» | 必填 | authParam | |
| 2 | data | 对象形式数据 | 字符 | 可选 | ||
| 3 | dataVlues | 数组形式数据 | 数组 | 可选 | ||
| 4 | approach | 订单录入方式 | 字符 | 10 | 可选 | 订单录入方式, 人工创建:0, 自动创建:1 |
| 5 | attachFiles | 工单附件 | 字符 | 200 | 必填 | 工单附件(逗号相连不超过200字符) |
| 6 | auditAttachment | 线下审核附件 | 字符 | 200 | 必填 | 线下审核附件。(逗号相连,不超过200字符) |
| 7 | auditMethod | 审核方式 | 整数 | 10 | 必填 | 审核方式 1.线上审核 2.线下审核 |
| 8 | auditingCompanyName | 审核单位名称 | 字符 | 250 | 必填 | 审核单位名称。(不超过250字符) |
| 9 | auditingTime | 审核通过时间 | 字符 | 50 | 可选 | 审核通过时间 |
| 10 | auditingUserName | 审核人 | 字符 | 250 | 可选 | 审核人。(不超过250字符) |
| 11 | author | 工单创建人 | 字符 | 250 | 必填 | 工单创建人。(不超过250字符) |
| 12 | authorCompanyName | 创建单位名称 | 字符 | 250 | 必填 | 创建单位名称。(不超过250字符) |
| 13 | callbackRequire | 反馈要求 | 字符 | 250 | 必填 | 反馈要求。(不能超过250个字符) |
| 14 | province | 省 | 字符 | 40 | 必填 | 省。(地理位置-省长度不能超过40个字符) |
| 15 | city | 市 | 字符 | 40 | 可选 | 市。(地理位置-省长度不能超过40个字符) |
| 16 | county | 区 | 字符 | 40 | 可选 | 区。(地理位置-省长度不能超过40个字符) |
| 17 | companyName | 工单所属单位名称 | 字符 | 200 | 必填 | 工单所属单位名称。(不能超过200个字符) |
| 18 | createdAt | 记录创建时间 | 字符 | 50 | 必填 | 记录创建时间。 |
| 19 | dataClassify | 数据归档 | 字符 | 10 | 可选 | 0.省厅下发 1.地市上报 |
| 20 | eventFrom | 事件来源 | 字符 | 100 | 可选 | 事件来源。(不能超过100个字符) |
| 21 | finalJudgeCompanyName | 终审单位名称 | 字符 | 250 | 可选 | 终审单位名称。(不超过250字符) |
| 22 | finalJudgeTime | 终审完成时间 | 字符 | 50 | 必填 | 终审完成时间 |
| 23 | finalJudgeUserName | 终审人 | 字符 | 250 | 可选 | 终审人。(不超过250字符) |
| 24 | industry | 单位所属行业 | 字符 | 50 | 可选 | 单位所属行业 |
| 25 | manufacturer | 发现厂商 | 字符 | 50 | 可选 | 发现厂商 |
| 26 | manufacturerDevice | 发现厂商设备 | 字符 | 50 | 可选 | 发现厂商设备 |
| 27 | overtime | 超时情况 | 字符 | 10 | 可选 | 超时情况0.超时 1.正常 |
| 28 | overtimeAt | 超时时间 | 字符 | 50 | 必填 | 超时时间。(工单处置截止时间) |
| 29 | priority | 紧急程度 | 字符 | 10 | 可选 | 一般重要紧急特别紧急 |
| 30 | receivedCompanyName | 签收单位名称 | 字符 | 250 | 可选 | 签收单位名称。(不超过250字符) |
| 31 | receivedTime | 签收时间 | 字符 | 50 | 可选 | 签收时间 |
| 32 | receivedUserName | 签收人 | 字符 | 250 | 可选 | 签收人。(不超过250字符) |
| 33 | securityInfo | 举证信息 | 字符 | 可选 | 安全的举证信息json串 | |
| 34 | securityObject | 工单下发对象 | 字符 | 100 | 可选 | 工单对象, 如: IP, 主机名, 服务器, 部门等 |
| 35 | serialId | 工单编号 | 字符 | 200 | 必填 | 工单编号。(不能超过200个字符) |
| 36 | severityLevel | 严重级别 | 字符 | 10 | 可选 | 严重级别(安全事件分为四类严重级别:特别重大事件、重大事件、较大事件、一般事件;风险隐患分为三类严重级别:高、中、低) |
| 37 | subject | 工单主题 | 字符 | 200 | 必填 | 工单主题。(不能超过200个字符) |
| 38 | supervisionCompanyName | 处置单位名称 | 字符 | 250 | 必填 | 处置单位名称。(不超过250字符) |
| 39 | supervisionTime | 处置完成时间 | 字符 | 50 | 可选 | 处置完成时间 |
| 40 | supervisionUserName | 处置人 | 字符 | 250 | 必填 | 处置人。(不超过250字符) |
| 41 | tags | 标签名称 | 字符 | 50 | 标签名称, 逗号分隔 | |
| 42 | workOrderType | 工单类型 | 整数 | 10 | 必填 | 工单类型 0:安全事件,1:风险隐患 |
| 43 | timestamp | 请求发起时间戳 | 整数 | 64 | 必填 | |
| 44 | sign | md5(timestamp+user+token) | 字符 | 32 | 必填 | |
| 45 | total | 记录条数 | 整数 | 32 | 可选 | |
| 46 | user | 用户账户 | 字符 | 30 | 必填 |
返回参数:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 说明 |
|---|---|---|---|---|
| 1 | errorCode | 接口状态码 | 字符 | |
| 2 | errorMessage | 接口消息 | 字符 | |
| 3 | data | 接口数据 | 对象 | |
| 4 | success | 是否成功 | 布尔 | true:成功,false:错误 |
返回示例:
{"data": {},"errorCode": "","errorMessage": "","success": true}
