宝塔面板的api说明手册及简单使用

几年前建站还是有点门槛的，自从各种一键安装web环境，web面板出现后，整个建站行业受到了9999点暴击。最好用的应该就是宝塔面板了，从它发布开始，就受到不少人的追捧。宝塔面板是使用浏览器来进行管理的，那么也就是说它是和网页一样的操作方式来管理服务器。最近宝塔官方发布了部分api，供大家自定义管理面板，这些api通过浏览器进行抓包就能抓到，下面我们一起来看看这些api怎么使用。

宝塔api说明手册pdf地址：https://www.bt.cn/api-doc.pdf

首先是签名算法，每次请求必须有由签名算法计算出的签名服务器才会响应。

api_sk = 接口密钥 (在面板设置页面 – API 接口中获取)
request_time = 当前请求时间的 uinx 时间戳 ( php: time() / python: time.time() )
request_token = md5(string(request_time) + md5(api_sk))
PHP 示例：
$request_token = md5($request_time . ‘’ . md5($api_sk))
参数说明
request_time 当前 uinx 时间戳 [必传]
request_token md5(string(request_time) + md5(api_sk)) [必传]
其它参数功能接口需要的其它参数 [可选]
注意事项：
请统一使用 POST 方式请求 API 接口
为了确保请求效率，请保存 cookie，并在每次请求时附上 cookie
为了面板安全考虑，请务必添加 IP 白名单
所有响应内容统一为 Json 数据格式
官方示例
if($bt_key) $this->BT_KEY = $bt_key;
}

//示例取面板日志
public function GetLogs(){
//拼接URL地址
$url = $this->BT_PANEL.’/data?action=getData’;

//准备POST数据
$p_data = $this->GetKeyData(); //取签名
$p_data[‘table’] = ‘logs’;
$p_data[‘limit’] = 10;
$p_data[‘tojs’] = ‘test’;

//请求面板接口
$result = $this->HttpPostCookie($url,$p_data);

//解析JSON数据
$data = json_decode($result,true);
return $data;
}

/**
* 构造带有签名的关联数组
*/
private function GetKeyData(){
$now_time = time();
$p_data = array(
‘request_token’ => md5($now_time.”.md5($this->BT_KEY)),
‘request_time’ => $now_time
);
return $p_data;
}

/**
* 发起POST请求
* @param String $url 目标网填，带http://
* @param Array|String $data 欲提交的数据
* @return string
*/
private function HttpPostCookie($url, $data,$timeout = 60)
{
//定义cookie保存位置
$cookie_file=’./’.md5($this->BT_PANEL).’.cookie’;
if(!file_exists($cookie_file)){
$fp = fopen($cookie_file,’w+’);
fclose($fp);
}

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_COOKIEJAR, $cookie_file);
curl_setopt($ch, CURLOPT_COOKIEFILE, $cookie_file);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$output = curl_exec($ch);
curl_close($ch);
return $output;
}
}

//实例化对象
$api = new bt_api();
//获取面板日志
$r_data = $api->GetLogs();
//输出JSON数据到浏览器
echo json_encode($r_data);
?>
返回的数据都是json类型，目前宝塔提供的api不够全面，比如我要通过指定字段搜索网站，宝塔只提供了一个模糊搜索的接口，不好用，需要自己构造排除数据，浪费时间性能。