让代码更简单

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

重要:本文最后更新于2019-03-01 08:27:07,某些文章具有时效性,若有错误或已失效,请在下方留言或联系代码狗

几年前建站还是有点门槛的,自从各种一键安装web环境,web面板出现后,整个建站行业受到了9999点暴击。最好用的应该就是宝塔面板了,从它发布开始,就受到不少人的追捧。宝塔面板是使用浏览器来进行管理的,那么也就是说它是和网页一样的操作方式来管理服务器。最近宝塔官方发布了部分api,供大家自定义管理面板,这些api通过浏览器进行抓包就能抓到,下面我们一起来看看这些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)) [必传]
  • 其它参数 功能接口需要的其它参数 [可选]

注意事项:

  1. 请统一使用 POST 方式请求 API 接口
  2. 为了确保请求效率,请保存 cookie,并在每次请求时附上 cookie
  3. 为了面板安全考虑,请务必添加 IP 白名单
  4. 所有响应内容统一为 Json 数据格式

官方示例

复制
<?php 
/** 
* 宝塔API接口示例Demo * 仅供参考,请根据实际项目需求开发,并做好安全处理 * date 2018/12/12 * author 阿良 */ 
class bt_api { 
        private $BT_KEY = "u6dS9qE1pyRZDnTpYrZiwaHqo5pSgXCO"; //接口密钥 
        private $BT_PANEL = "http://127.0.0.1:8888"; //面板地址 
       //如果希望多台面板,可以在实例化对象时,将面板地址与密钥传入 
    public function __construct($bt_panel = null,$bt_key = null){ 
                if($bt_panel) $this->BT_PANEL = $bt_panel;
		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不够全面,比如我要通过指定字段搜索网站,宝塔只提供了一个模糊搜索的接口,不好用,需要自己构造排除数据,浪费时间性能。

感觉很棒!可以赞赏支持我哟~

4 打赏

评论 (4)

登录后评论
第二次听说这个工具,看来是个好东西
用起来十分方便,功能也很强大,不影响添加自定义功能。
不了解的东西太多,学不过来
学习了 感谢
QQ咨询 邮件咨询 狗哥推荐