宝塔-获取服务器实时信息免费API接口教程

728528526

接口简介：
获取服务器实时信息，如网速，CPU，磁盘，内存等使用信息，需要服务器已安装宝塔面板。可用于多台服务器状态管理大盘制作等场景。

请求地址：
https://cn.apihz.cn/api/baota/info.php

请求方式：
POST或GET。

请求参数：
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【接口盒子用户中心的数字ID，例：id=10000000】
【用户KEY】【key】【是】【接口盒子用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】
【宝塔接口地址】【btapi】【是】【宝塔服务器接口地址，一般是宝塔面板地址，不带后面的安全入口参数，只需要域名加端口，例：btapi=http://123.123.123.123:8888】
【宝塔接口秘钥】【btkey】【是】【接口访问秘钥，需要在宝塔面板设置里，找到API接口配置，开启接口访问，白名单IP必须填写0.0.0.0，然后重启面板或服务器。如在非安全环境下调用本接口，可将秘钥等私密参数托管到接口盒子，使用接口盒子的云托管接口来中转调用此接口，详情请登录接口盒子后台查看【云托管】菜单。例：btkey=eh125r56561kjtyu5145ws5r】

返回参数：
【名称】【参数】【说明】
【状态码】【code】【200成功，400错误】
【消息内容】【msg】【如果状态码返回400则msg返回错误信息提示。】
【服务器名称】【title】【服务器名称】
【操作系统】【system】【操作系统】
【操作系统版本】【simple_system】【操作系统版本】
【网站总数】【site_total】【网站总数】
【FTP数量】【ftp_total】【FTP数量】
【数据库数量】【database_total】【数据库数量】
【持续运行时间】【time】【持续运行时间】
【宝塔版本】【version】【宝塔版本】
【CPU型号】【cpuModel】【CPU型号】
【CPU使用率】【cpu】【CPU使用率】
【CPU总个数】【cpunum】【CPU总个数】
【总进程数】【jcnum】【总进程数】
【活动进程数】【jcnum2】【活动进程数】
【磁盘总大小】【totalSize】【所有磁盘总大小 字节】
【磁盘总已使用】【totalUsed】【磁盘总已使用大小 字节】
【磁盘总使用率】【usageRate】【磁盘总使用率 百分比】
【上行速度】【up】【上行速度 KB】
【下行速度】【down】【下行速度 KB】
【上行总流量】【upTotal】【上行总流量 字节】
【下行总流量】【downTotal】【下行总流量 字节】
【发送包数】【upPackets】【发送数据包总个数】
【接收包数】【downPackets】【接收数据包总个数】
【系统负载】【load1】【近一分钟系统负载】
【系统负载】【load5】【近五分钟系统平均负载】
【系统负载】【load15】【近十五分钟系统平均负载】
【内存使用率】【mem】【内存使用率 百分比】
【总内存大小】【memTotal】【总内存大小 单位M】
【实际使用内存】【memRealUsed】【实际使用内存 单位M】
【实际使用内存】【memNewRealUsed】【实际使用内存 单位GB】
【空闲内存】【memFree】【空闲内存 未被任何程序或缓存占用 单位M】
【缓冲区内存】【memBuffers】【缓冲区内存 用于临时存储磁盘I/O操作的数据 单位M】
【缓存内存】【memCached】【缓存内存 存储频繁访问的文件数据（可快速释放供程序使用） 单位M】
【可用内存】【memAvailable】【可用内存 包含memFree + 可释放的Buffers/Cached内存 单位M】
【共享内存】【memShared】【共享内存 多个进程共同使用的内存（如进程间通信） 单位M】
【格式化总内存】【memNewTotal】【格式化后总内存大小】

GET请求示例：
https://cn.apihz.cn/api/baota/info.php?id=88888888&key=88888888&btapi=http://123.123.123.123:8888&btkey=eh125r56561kjtyu5145ws5r
注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。

POST请求示例：
请根据开发语言自行POST。

返回数据示例：
示例：{"code":400,"msg":"cha询失败，请重试。"}
示例：
{
    "code": 200,
    "title": "测试服务器",
    "system": "CentOS  7.9.2009 x86_64(Py3.7.9)",
    "simple_system": "CentOS 7",
    "site_total": 4,
    "ftp_total": 0,
    "database_total": 0,
    "time": "10天",
    "version": "9.5.0",
    "cpuModel": "Intel(R) Xeon(R) CPU E5-26xx v4 * 1",
    "cpu": 1.8,
    "cpunum": 4,
    "cpujc": 169,
    "cpujc2": 1,
    "totalSize": 271708209152,
    "totalUsed": 187411193856,
    "usageRate": 68.98,
    "up": 12.58,
    "down": 20.29,
    "upTotal": 85362061103,
    "downTotal": 63776284578,
    "upPackets": 208881067,
    "downPackets": 352217398,
    "load1": 0.01,
    "load5": 0.06,
    "load15": 0.05,
    "mem": 14.85,
    "memTotal": 15533,
    "memRealUsed": 2307,
    "memNewRealUsed": "2.3",
    "memFree": 7790,
    "memBuffers": 3027,
    "memCached": 2409,
    "memAvailable": 12868,
    "memShared": 21,
    "memNewTotal": "15GB"
}

参考资料(版权)：
https://www.apihz.cn/api/baotainfo.html

wuage

谢谢分享