API接口使用教程

通过宝塔API，可以完全控制宝塔Linux面板的所有功能，包括第三方插件应用功能，事实上，在用户登录面板后使用的所有功能也是通过相同的接口对接的，这意味着，如果你熟悉使用浏览器调试器，就可以轻松对照宝塔Linux面板的操作参数完成一个第三方的前端对接。

API文档(未写完)：https://www.bt.cn/api-doc.pdf
PHP-Demo:  https://www.bt.cn/api_demo_php.zip
Python-Demo:  https://www.bt.cn/api_demo_python.zip

第三方PHP-SDK(感谢Youngxj) : https://www.bt.cn/bbs/forum.php?mod=viewthread&tid=23895

操作数据库的api，还没有吗？

API文档很方便，省去了使用账号密码登录的烦恼。
以前手动添加网站，真是痛苦不堪。十几台服务器。一个站几十个域名，还要为每个域名单独做证书。每天都要花一两个小时打理站点。有这种通用的API，不到50行代码，就能实现批量网站上传添加了。使用这种通用的api方式还是很赞的
放个思路给大家参考一下

1.     def stie_run(self):
   
2.         path_key = os.path.join(ssl_data['path'],ssl_data['key'])
   
3.         path_csr = os.path.join(ssl_data['path'],ssl_data['crt'])
   
4.         """
   
5.         domain 传入参数,static 和 server 设置伪静态和nginx配置
   
6.         path_key 证书key的目录 path_csr 证书csr的目录
   
7.         第一步 创建网站
   
8.         第二步 设置伪静态
   
9.         第三步 上传SSL证书
   
10.         第四步 配置文件上传
    
11.         """
    
12.         self.add_site(domain)  # 创建网站
    
13.         self.save_file_body('static', domain)  # 设置伪静态
    
14.         self.set_SSL(domain, path_key, path_csr)  # 上传SSL证书
    
15.         self.save_file_body('server', domain)  # 配置文件上传

复制代码

时间仓促，不过已经能够降低重复的工作了。运行效率也明显比单个添加要简单的多了，单个服务器操作已经是分钟级别了

1. #发送POST请求并保存Cookie
   
2. #@url 被请求的URL地址(必需)
   
3. #@data POST参数，可以是字符串或字典(必需)
   
4. #@timeout 超时时间默认1800秒
   
5. #return string
   
6. def __http_post_cookie(self,url,p_data,timeout=1800):
   
7.     cookie_file = './' + self.__get_md5(self.__BT_PANEL) + '.cookie';
   
8.     if sys.version_info[0] == 2:
   
9.         #Python2
   
10.         import urllib,urllib2,ssl,cookielib
    
11. 
    
12.         #创建cookie对象
    
13.         cookie_obj = cookielib.MozillaCookieJar(cookie_file)
    
14. 
    
15.         #加载已保存的cookie
    
16.         if os.path.exists(cookie_file):cookie_obj.load(cookie_file,ignore_discard=True,ignore_expires=True)
    
17. 
    
18.         ssl._create_default_https_context = ssl._create_unverified_context
    
19. 
    
20.         data = urllib.urlencode(p_data)
    
21.         req = urllib2.Request(url, data)
    
22.         opener = urllib2.build_opener(urllib2.HTTPCookieProcessor(cookie_obj))
    
23.         response = opener.open(req,timeout=timeout)
    
24. 
    
25.         #保存cookie
    
26.         cookie_obj.save(ignore_discard=True, ignore_expires=True)
    
27.         return response.read()
    
28.     else:
    
29.         #Python3
    
30.         import urllib.request,ssl,http.cookiejar
    
31.         cookie_obj = http.cookiejar.MozillaCookieJar(cookie_file)
    
32.         if os.path.exists(cookie_file):
    
33.             cookie_obj.load(cookie_file,ignore_discard=True,ignore_expires=True)
    
34.         handler = urllib.request.HTTPCookieProcessor(cookie_obj)
    
35.         data = urllib.parse.urlencode(p_data).encode('utf-8')
    
36.         req = urllib.request.Request(url, data)
    
37.         opener = urllib.request.build_opener(handler)
    
38.         response = opener.open(req,timeout = timeout)
    
39.         cookie_obj.save(ignore_discard=True, ignore_expires=True)
    
40.         result = response.read()
    
41.         if type(result) == bytes: result = result.decode('utf-8')
    
42.         return result
    
43. 
    

复制代码

修复一下官方接口的小bug，在类方法__http_post_cookie处加上一个文件判断，存在时读取文件，不存在时请求。避免了首次初始化运行不了的尴尬情况
python3和python2通用的，可以自行修复

API的IP白名单是否可以全部允许？如填入*.*.*.*

python的demobt_api类中的__http_post_cookie 函数中报错


将函数代码

1. def __http_post_cookie(self,url,p_data,timeout=1800):
   
2.     cookie_file = './' + self.__get_md5(self.__BT_PANEL) + '.cookie'
   
3.     if sys.version_info[0] == 2:

复制代码

更改为

1. <blockquote>def __http_post_cookie(self,url,p_data,timeout=1800):
   
2.     cookie_file = './' + self.__get_md5(self.__BT_PANEL) + '.cookie'
   
3.     with open(cookie_file,"a") as file:
   
4.         file.write("# Netscape HTTP Cookie File\n")
   
5.     if sys.version_info[0] == 2:

复制代码

开发一个微信小程序版宝塔控制台，使用这些API。算侵权吗？

追忆网络 发表于 2019-2-26 23:03
文档不完善啊，我看创建网站和数据库 都没有容量这个参数嘛

本身就不支持容量控制

使用api的话，可以关闭后台面板吗？

文档不完善啊，我看创建网站和数据库 都没有容量这个参数嘛

ftp总是创建失败是为啥，站点和数据库都能成功 ，就ftp总是失败


知道了。。。ftp参数要传字符串的 true~~

宝塔用户_pxtxit 发表于 2019-2-3 19:23
都是在本地调试的，我每次登录面板IP都变，但是php的方法有几率成功，说明添加的白名单里有，c#和python都 ...

都可以，不过给的python demo不会自己创建cookie文件 ，必须要带cookies，不然请求的就是登录页面

vegisau 发表于 2018-12-14 00:29
获取全局配置
/config?action=get_config

获取全局配置API返回的结果太少了

宝塔用户_pxtxit 发表于 2019-2-3 19:17
只能请求到HTML py 和 c# 都是只有php能请求到json

都是在本地调试的，我每次登录面板IP都变，但是php的方法有几率成功，说明添加的白名单里有，c#和python都是得到的登录界面，请问这样要怎么设置已经解决）

只能请求到HTML py 和 c# 都是只有php能请求到json(已经解决)

现在接口还是太少了…