第三方平台定时将设备资产信息上报到本级平台。
设备资产内容包含但不限于第三方平台的资产名称、单位名称、资产类型、资产标签、责任人、资产重要性、ipv4、ipv6、mac地址、是否国产、是否物联网终端、互联网数据中心、资产编号、资产状态、使用人、机密性、完整性、可用性、区域、操作系统信息、设备信息等。
请求地址:/open/api/v1/ asset/add
接口类型: HTTP
请求方式:POST
请求参数:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 字段长度 | 必填/可选 | 说明 |
|---|---|---|---|---|---|---|
| 1 | user | 第三方系统用户名 | 文本 | 10 | 必填 | |
| 2 | timestamp | 请求发起时间戳 | 整数 | 64 | 必填 | |
| 3 | sign | md5(timestamp+user+token) | 字符 | 32 | 必填 | |
| 4 | dataValues | 对象数组 | 对象 | 必填 |
dataValues包含的字段:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 字段长度 | 必填/可选 | 说明 |
|---|---|---|---|---|---|---|
| 1 | name | 资产名称 | 字符 | 50 | 必填 | 资产名称 |
| 2 | companyName | 单位名称 | 字符 | 50 | 必填 | 单位存在,才能正常新增 |
| 3 | type | 资产类型 | 字符 | 10 | 可选 | 资产类型:详见附录B.1 补充说明枚举值 |
| 4 | tags | 资产标签 | 字符 | 50 | 可选 | 资产标签,逗号相连(自定义,如:网络,终端,云) |
| 5 | personInCharge | 责任人 | 字符 | 10 | 可选 | 责任人 |
| 6 | importance | 资产重要性 | 字符 | 10 | 可选 | 资产重要性:common|important |
| 7 | ipv4 | ipv4 | 字符 | 100 | 可选 | ipv4存放json数组 |
| 8 | ipv6 | ipv6 | 字符 | 100 | 可选 | ipv6存放json数组 |
| 9 | mac | Mac地址 | 字符 | 100 | 可选 | Mac地址 |
| 10 | domesticProduct | 是否国产 | 字符 | 10 | 可选 | 是否国产:1|0 |
| 11 | iotDevice | 是否物联网终端 | 字符 | 10 | 可选 | 是否物联网终端:1|0 |
| 12 | idc | 互联网数据中心 | 字符 | 10 | 可选 | 互联网数据中心 |
| 13 | code | 资产编号 | 字符 | 10 | 可选 | 资产编号 |
| 14 | status | 资产状态 | 字符 | 10 | 可选 | 资产状态,枚举:installed|testing|using|maintaining|spare|scrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废 |
| 15 | assetUser | 使用人 | 字符 | 10 | 可选 | 使用人 |
| 16 | confidentiality | 机密性 | 字符 | 10 | 可选 | 机密性,枚举:veryHigh|high|medium|low|ignorable含义分别是:非常高|高|中|低|可忽略 |
| 17 | integrity | 完整性 | 字符 | 10 | 可选 | 完整性,枚举:veryHigh|high|medium|low|ignorable含义分别是:非常高|高|中|低|可忽略 |
| 18 | availability | 可用性 | 字符 | 10 | 可选 | 可用性,installed|testing|using|maintaining|spare|scrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废 |
| 19 | hierarchyProtection | 是否是等保 | 字符 | 10 | 可选 | 是否是等保,枚举1|0 |
| 20 | province | 省名称 | 字符 | 10 | 可选 | 省名称 |
| 21 | city | 市名称 | 字符 | 10 | 可选 | 市名称 |
| 22 | county | 区名称 | 字符 | 10 | 可选 | 区名称 |
| 23 | description | 描述 | 字符 | 1000 | 可选 | 描述 |
| 24 | os | 操作系统 | 字符 | 10 | 可选 | 操作系统 |
| 25 | osVersion | 操作系统版本号 | 字符 | 10 | 可选 | 操作系统版本号 |
| 26 | deviceManufacturer | 设备厂商 | 字符 | 10 | 可选 | 设备厂商 |
| 27 | deviceModel | 设备型号 | 字符 | 30 | 可选 | 设备型号 |
| 28 | deviceVersion | 设备版本 | 字符 | 30 | 可选 | 设备版本 |
| 29 | storeLocation | 设备存放地址 | 字符 | 100 | 可选 | 设备存放地址 |
请求示例:
返回示例:{"dataValues": [{"name": "资产openapi-006", //资产名称【string, 必填】"companyName": "测试", //单位名称,单位存在,才能正常新增【string, 必填】"type": "54,59", // 资产类型:详见补充说明枚举值 【string, 选填】"tags": "111,222", // 资产标签,逗号相连 【string, 选填】"personInCharge": "xiaoming", // 责任人 【string, 选填】"importance": "important", // 资产重要性:common|important 【string, 选填】"ipv4": "[\"1.4.2.4\"]", // ipv4存放json数组【string, 选填】"ipv6": "[\"2001:0db8:85a3:0000:0000:8a2e:0370:7331\"]", // ipv6存放json数组【string, 选填】"mac": "[\"99:DD:6B:B3:45:0C\"]", // mac 【string, ipv4、ipv6、mac三个必须至少填1个】"domesticProduct": "0",// 是否国产:1|0【string, 选填】"iotDevice": "0", // 是否物联网终端:1|0【string, 选填】"idc": "idc111", // idc:互联网数据中心【string, 选填】"code": "code1111", //资产编号 【string, 选填】"status": "testing", // 资产状态,枚举:installed|testing|using|maintaining|spare|scrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废 【string, 选填】"assetUser": "xiaomei", // 使用人【string, 选填】"confidentiality": "high", // 机密性,枚举:veryHigh|high|medium|low|ignorable含义分别是:非常高|高|中|低|可忽略【string, 选填】"integrity": "medium", // 完整性,枚举:veryHigh|high|medium|low|ignorable含义分别是:非常高|高|中|低|可忽略【string, 选填】"availability": "maintaining", // 可用性,installed|testing|using|maintaining|spare|scrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废 【string, 选填】"hierarchyProtection": 1, // 是否是等保,枚举 1|0 【string, 选填】"province": "浙江省", // 省名称【string, 选填】"city": "杭州市", // 市名称【string, 选填】"county": "滨江区", // 区名称【string, 选填】"description": "description1111", // 描述 【string, 选填】"os": "os1111", // 操作系统 【string, 选填】"osVersion": "osvesion111", // 操作系统版本号 【string, 选填】"deviceManufacturer": "设备厂商111", // 设备厂商 【string, 选填】"deviceModel": "设备型号111", // 设备型号 【string, 选填】"deviceVersion": "设备版本111", // 设备版本 【string, 选填】"storeLocation": "设备存放地址111"// 设备存放地址 【string, 选填】}],"sign": "xxxxxxxxxxx","timestamp": 1620464511673,"user": "xxxx"}
返回参数:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 说明 |
|---|---|---|---|---|
| 1 | errorCode | 接口状态码 | 字符 | |
| 2 | errorMessage | 接口消息 | 字符 | |
| 3 | data | 接口数据 | 对象 | |
| 4 | success | 是否成功 | 布尔 | true:成功,false:错误 |
返回示例:
{"data": {},"errorCode": "","errorMessage": "","success": true}
