# systeminfo-api **Repository Path**: vincent-winner/systeminfo-api ## Basic Information - **Project Name**: systeminfo-api - **Description**: 基于 SpringBoot 的 系统信息 Api 服务 - **Primary Language**: Java - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-03-16 - **Last Updated**: 2021-06-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 系统信息 Api 注意: - 接口名称按照英文命名，参照英文名含义和表格中的注释理解接口用途 - 返回类型为 text 的接口会直接返回数据值，没有任何结构 - 例子中的 json 数据为表格中返回类型为访问 Api 根路径的结果 ## 1.基本计算机硬件信息 --- |Api路径|说明|返回数据类型|接受请求类型| |:---|:---|:---:|:---:| |/computer|同 /computer/static|json|全部| |/computer/manufacturer|制造商|text|全部| |/computer/model|型号|text|全部| |/computer/serialNumber|序列号|text|全部| |/computer/static|详见下列例子|json|全部| |/computer/uuid|唯一硬件标识符|text|全部| ### 例子 ``` { "hardwareUUID": "4C4C4544-0051-3810-804A-B5C0XXXXXXXX", "serialNumber": "5Q8XXXX", "manufacturer": "Dell Inc.", "computerModel": "G3 3579" } ``` ## 2.操作系统信息 --- |Api路径|说明|返回数据类型|接受请求类型| |:---|:---|:---:|:---:| |/os|全部系统信息|json|全部| |/os/arch|系统架构|text|全部| |/os/bit|系统位数|text|全部| |/os/version|系统版本|text|全部| |/os/dynamic|动态操作系统信息|json|全部| |/os/static|静态操作系统信息|json|全部| |/os/fileSeparator|文件分隔符|text|全部| |/os/lineSeparator|行分隔符|text|全部| |/os/pathSeparator|路径分隔符|text|全部| |/os/name|系统名称|text|全部| |/os/processCount|进程总数|text|全部| |/os/threadCount|线程总数|text|全部| |/os/sinceBootTime|自自动至现在的时间|text|全部| |/os/userName|当前用户名|text|全部| |/os/userHome|当前用户家目录|text|全部| ### 例子 ``` { "sinceBootTime": 41518, "userHome": "C:\Users\abc", "osVersion": "10.0", "pathSeparator": ";", "fileSeparator": "\", "threadCount": 3316, "arch": "amd64", "osName": "Windows 10", "userName": "abc", "lineSeparator": "\r\n", "bit": 64, "processesCount": 264 } ``` ## 3.CPU 信息 --- |Api路径|说明|返回数据类型|接受请求类型| |:---|:---|:---:|:---:| |/cpu|全部 CPU 信息|json|全部| |/cpu/dynamic|动态 CPU 信息|json|全部| |/cpu/static|静态 CPU 信息|json|全部| |/cpu/family|产品族|text|全部| |/cpu/logicCoreNum|逻辑核心数量|text|全部| |/cpu/physicalCoreNum|物理核心数量|text|全部| |/cpu/vendorFreq|出厂频率|text|全部| |/cpu/maxFreq|最大频率|text|全部| |/cpu/model|型号|text|全部| |/cpu/name|名称|text|全部| |/cpu/stepping|步进|text|全部| |/cpu/vendor|制造商|text|全部| |/cpu/isCpu64Bit|CPU 是否为64bit|text|全部| |/cpu/usage|CPU 使用率|text|全部| ### 例子 ``` { "cpuStepping": "10", "cpuUsage": 0.09211878234601382, "logicalCoreNum": 12, "physicalCoreNum": 6, "cpuVendor": "GenuineIntel", "cpuModel": "158", "cpuMaxFreq": 2208000000, "cpuFamily": "6", "cpuName": "Intel(R) Core(TM) i7-8750H CPU @ 2.20GHz", "cpuVendorFreq": 2208000000 } ``` ## 4.内存信息 注意： - Windows 系统的内存交换分区为分页文件 --- |Api路径|说明|返回数据类型|接受请求类型| |:---|:---|:---:|:---:| |/memory|全部内存信息|json|全部| |/memory/dynamic|动态内存信息|json|全部| |/memory/static|静态内存信息|json|全部| |/memory/physicalTotal|内存空间总量|text|全部| |/memory/physicalFree|空闲内存空间|text|全部| |/memory/physicalUsed|已使用内存空间|text|全部| |/memory/physicalUsage|内存空间使用率|text|全部| |/memory/swapTotal|交换分区容量|text|全部| |/memory/swapFree|交换分区空限量|text|全部| |/memory/swapUsed|交换分区使用量|text|全部| |/memory/swapUsage|交换分区使用率|text|全部| |/memory/memoryNum|内存条数量|text|全部| ### 例子 ``` { "physicalFree": 6055518208, "swapFree": 5016707072, "swapUsage": 0.0316910789830077, "physicalUsage": 0.6444751082940771, "memoryChips": [ { "memoryType": "DDR4", "clockSpeed": 2667000000, "bankLabel": "", "capacity": 8589934592, "manufacturer": "802C0000802C" }, { "memoryType": "DDR4", "clockSpeed": 2667000000, "bankLabel": "", "capacity": 8589934592, "manufacturer": "859B0000802C" } ] } ``` ## 5.磁盘信息 注意: - 下列表格中的 `{diskNum}` 为变量，代表磁盘编号 - 磁盘编号从`1`开始 - 当磁盘编号小于 `0` 时，查看本程序所在磁盘的相应信息 - 当磁盘编号大于 `/disk/diskNum`所获取的值时，所有结果均为 0 --- |Api路径|说明|返回数据类型|接受请求类型| |:---|:---|:---:|:---:| |/disk|全部磁盘信息|json|全部| |/disk/dynamic|动态磁盘信息|json|全部| |/disk/static|静态磁盘信息|json|全部| |/disk/totalSpace/{diskNum}|指定编号磁盘总空间|text|全部| |/disk/freeSpace/{diskNum}|指定编号磁盘空闲空间|text|全部| |/disk/usedSpace/{diskNum}|指定编号磁盘已使用空间|text|全部| |/disk/usage/{diskNum}|指定编号磁盘使用率|text|全部| |/disk/diskNum|全部磁盘数量|text|全部| ### 例子 ``` { "staticDiskInfo": [ { "diskName": "本地固定磁盘 (C:)", "mountPoint": "C:\\", "usedSpace": 106211897344, "freeSpace": 5640749056, "usage": 106211897344, "logicVolume": "", "description": "Fixed drive", "label": "OS", "totalSpace": 111852646400, "type": "NTFS", "uuid": "ff99d5e1-0c99-45d5-870b-44a4ab7e5f49", "volume": "\\\\?\\Volume{ff99d5e1-0c99-45d5-870b-44a4ab7e5f49}\\", "options": "rw,reparse,sparse,trans,journaled,quota,casess,oids,casepn,efs,streams,unicode,acls,fcomp" }, { "diskName": "本地固定磁盘 (D:)", "mountPoint": "D:\\", "usedSpace": 924274401280, "freeSpace": 75792371712, "usage": 924274401280, "logicVolume": "", "description": "Fixed drive", "label": "DATA", "totalSpace": 1000066772992, "type": "NTFS", "uuid": "ac6cf8aa-2cf2-43f8-b164-26c0237478a3", "volume": "\\\\?\\Volume{ac6cf8aa-2cf2-43f8-b164-26c0237478a3}\\", "options": "rw,reparse,sparse,trans,journaled,quota,casess,oids,casepn,efs,streams,unicode,acls,fcomp" }, { "diskName": "本地固定磁盘 (V:)", "mountPoint": "V:\\", "usedSpace": 1850441662464, "freeSpace": 149612134400, "usage": 1850441662464, "logicVolume": "", "description": "Fixed drive", "label": "Vincent", "totalSpace": 2000053796864, "type": "exFAT", "uuid": "84630a67-0000-0000-0080-000000000000", "volume": "\\\\?\\Volume{84630a67-0000-0000-0080-000000000000}\\", "options": "rw,casepn,efs,unicode" } ], "dynamicDiskInfo": [ { "freeSpace": 5640749056, "diskUsage": 0.9495698203167413, "diskNum": 1 }, { "freeSpace": 75792371712, "diskUsage": 0.9242126888335223, "diskNum": 2 }, { "freeSpace": 149612134400, "diskUsage": 0.9251959449117891, "diskNum": 3 } ] } ```