请选择 进入手机版 | 继续访问电脑版

kangle软件 是一款高性能跨平台web服务器

 找回密码
 注册
kangle web软件将启用新域名 kangleweb.com 作为kangle软件官方网站网址
kangle web服务器最新版下载
kangle访问控制模块介绍 -  kangle设置优化原则
kangle中文帮助手册 -产品购买
easypanel 虚拟主机控制面板最新版
easypanel虚拟主机控制面板功能列表
easypanel中文帮助手册 - 讨论
   kangle虚拟主机管理下载 - 安装 - 帮助手册
    
   销售: 在线客服QQ   技术支持: 在线客服QQ
    kangle web (介绍, 功能特性, 运行环境, 安装说明, 常见问题, 使用教程)     easypanel主机控制面板 (介绍, 功能特性, 安装说明, 常见问题, 使用教程)
    vhms系统 (介绍, 安装说明, 常见问题, 使用教程)     [kangle软件交流QQ群:104434948]
查看: 34522|回复: 16

easypanel API接口查询

[复制链接]
发表于 2015-11-30 15:57:40 | 显示全部楼层 |阅读模式
为方便大家对接easypanel,现将easypanel的对外接口逐一贴出,让有能力的人集成或开发出比vhms更好用的管理系统。
此贴只讨论api接口相关的问题。请勿灌水。
先开贴,有空的时候我会一个一个贴。
回复

使用道具 举报

发表于 2017-2-7 00:19:37 | 显示全部楼层
本帖最后由 千里溃 于 2017-2-7 00:24 编辑
spaceworld 发表于 2015-12-2 15:47
api接口地址
因easypanel自动绑定侦听了3312端口并加了泛绑定。
所以用IP或者解析到了服务器IP的域名都可以 ...


秘钥,通过md5(a + skey +r)得到,如a=add,skey=test,r=888,则s=md5(addtest888)
这个方法我个人认为不足够安全,一旦被他人截获URL其中的秘钥就会被截获,能被利用到其他操作上,其安全性低。
建议加入时间变量以及对操作数据进行md5编码(对操作进行排序然后拼接URL然后md5加密,最后在URL后面带上加密字符串)提高安全性。
回复 支持 0 反对 1

使用道具 举报

 楼主| 发表于 2015-12-2 15:47:15 | 显示全部楼层
api接口地址
因easypanel自动绑定侦听了3312端口并加了泛绑定。
所以用IP或者解析到了服务器IP的域名都可以。
url如下:
  1. http://服务器IP地址(或域名):3312/api/index.php
复制代码





api接口权限验证
每发送一条api调用,必需带的参数有:
  1. c : (control)表示哪个控制文件(目前有whm,cdn)
  2. a : (action)表示哪个方法,以下介绍
  3. r : 随机数
  4. s : 秘钥,通过md5(a + skey +r)得到,如a=add,skey=test,r=888,则s=md5(addtest888)

  5. 其中skey是服务器安全码
复制代码

如:
  1. http://192.168.1.20:3312/api/index.php?c=whm&a=add&r=888&s=8e4fc6f181bedf11c64bac3bf341ca6a
复制代码


如果验证s不通过,你会得到以下的返回
  1. {"result":403,"msg":"\u6743\u9650\u9519\u8bef,\u8bf7\u68c0\u67e5\u901a\u4fe1\u5b89\u5168\u7801\u662f\u5426\u6b63\u786e"}
复制代码



接口的返回数据
如果接口加了json=1参数过来,你将得到json数据。如果没有,将得到xml数据。
友情提示:请最好带json=1参数过来。以后的接口默认情况下考虑输出json。
回复 支持 反对

使用道具 举报

 楼主| 发表于 2015-12-2 16:04:08 | 显示全部楼层
spaceworld 发表于 2015-12-2 15:47
api接口地址
因easypanel自动绑定侦听了3312端口并加了泛绑定。
所以用IP或者解析到了服务器IP的域名都可以 ...


获取easypanel的信息(包括了kangle的信息)
c : whm
a : info
调用成功后你将得到如下返回数据:
  1. {"result":200,"server":[{"0":"kangle"}],"version":[{"0":"3.4.8"}],"type":[{"0":"enterprise"}],"os":[{"0":"windows"}],"license_id":[{"0":"73646_1387957818"}],"license_name":[{"0":"dsdds"}],"total_run":[{"0":"611038"}],"connect":[{"0":"4"}],"request":[{"0":"14105"}],"accept":[{"0":"4722"}],"vh":[{"0":"43"}],"kangle_home":[{"0":"D:\\\easypanel\"}],"update_code":[{"0":"win_x64"}],"easypanel_version":"2.6.17"}
复制代码

其中result=200表示调用成功。
version是kangle的版本
type是kangle的商业版还是免费版(enterprise  or free)
total_run 是运行时间
vh 是虚拟主机数量
connect是当前有多少请求进来。