avatar

目录
kangle服务器 - easypanel API 文档

下载与之匹配的接口文件(PHP)

类型 下载地址

easypanel_PHP_SDK.zip

接口概览

Easypanel的api通信安全码在easypanel的服务器设置处设置。

  • 有以下接口接口:
接口名称 用途
add_vh 创建空间和修改空间
update_vh 暂停空间和恢复空间
del_vh 删除空间
change_password 修改空间的密码
  • 通用返回信息:(返回内容为xml/json格式)

    • 安全码错误的返回信息:
    xml
    1
    <add_vh whm_version="1.0"><result status='403 sign error'></result></add_vh>
    • 创建、修改、删除创建成功的返回信息:
    xml
    1
    <?xml version="1.0" encoding="utf-8"?><add_vh whm_version="1.0"><result status='200'></result></add_vh>
    • 创建、修改、删除失败的返回信息:
    xml
    1
    <?xml version="1.0" encoding="utf-8"?><add_vh whm_version="1.0"><result status='500'></result></add_vh>

add_vh:创建空间

  • 接口地址及方法

    • 地址: 域名:3312/api/
    • 方法: GET
  • 参数

    • 固定参数

      参数名 说明 (默认)值
      c 固定 whm
      a 操作名称(固定) add_vh
      s 验证密钥,构成方式:md5(a.easypanel安全码.r) 例(安全码为test):md5(add_vhtest1000)
      Init 表示创建空间,固定为1即可 1
      Name 网站账号,数据库账号,ftp账号同步
      Passwd 网站密码,数据库密码,ftp密码同步(只创建时同步)
    • 可选参数

      参数名 说明 (默认)值
      Product_id easypanel里的产品ID
      Product_name easypanel里的产品名称
      vhost_domains 绑定域名
      Cdn 是否为CDN空间,是则发送1
      Templete 语言(html|php|iis)
      Subtemplete 语言引擎,php52|php53|php5217
      web_quota 网页空间大小,数字
      db_quota 数据库大小,数字
      db_type 数据库类型,mysql|sqlsrv
      subdir_flag 是否允许绑定子目录,1为是
      Subdir 默认绑定目录,可为空,例:wwwroot
      max_subdir 最多子目录数
      Domain 最大绑定域名数,可空,默认会绑定到subdir指 定的目录下
      ftp 是否开启ftp,1为是
      ftp_connec ftp最多连接数
      ftp_usl ftp上传速度限制,单位kb
      ftp_dsl ftp下载限制。单位kb
      Access 是否自定义控制,1为是
      speed_limit 带宽限制,数字型,默认为不限
      log_handle 是否开启日志析分功能,1为是
      flow_limit 流量限制,数字型 默认不限
      max_connect 空间最多连接数,可空 默认采用kangle全局配置
      max_worker 最多工作者,可空 默认采用kangle全局配置
      ignore_backup 是否备份,1为是
  • 示例

    bash
    URL
    1
    域名:3312/api/?c=whm&a=add_vh&r=3333&s=(md5)&name=webtest&passwd=webpasswd&init=1&product_name=php100
    bash
    URL
    1
    域名:3312/api/?c=whm&a=add_vh&r=3333&s=aaadddsfsdfaslkdfEsdfsad&name=webtest&passwd=webpasswd&templete=php&subtemplete=php52&web_quota=1000&db_quota=1000&db_type=mysql&ftp=1&ftp_connect=3&ftp_usl=50&ftp_dsl=50&access=1&speed_limit=100&log_handle=1&flow_limit=3000&ignore_backup=1&domain=www.kanglesoft.com&subdir_flag=1&subdir=wwwroot&max_subdir=3
  • add_vh:升级网站或者修改网站参数

  • 其他参数和创建网站一样,只是需要把init=1换成edit=1即可。

  • 例:

    bash
    URL
    1
    域名:3312/api/?c=whm&a=add_vh&r=3333&s=adasdfasdf2322344&name=webtest&edit=1&product_name=newproduct

update_vh:暂停和恢复网站

  • 接口地址及方法

    • 地址: 域名:3312/api/
    • 方法: GET
  • 参数

    • 固定参数

      参数名 说明 (默认)值
      c 固定 whm
      a 操作名称(固定) update_vh
      r 随机数(1000-99999)
      S 验证密钥。构成方式请参考创建空间说明 例:md5(update_vhtest3333)
      Name 网站名称
      Status 网站的状态 0为恢复,1为暂停
  • 示例

    bash
    URL
    1
    域名:3312/api/?c=whm&a=update_vh&r=3333&s=adasdfasdf2322344&name=webtest&status=0

del_vh:删除网站

  • 接口地址及方法

    • 地址: 域名:3312/api/
    • 方法: GET
  • 参数

    • 固定参数

      参数名 说明 (默认)值
      c 固定 whm
      a 操作名称(固定) del_vh
      r 随机数(1000-99999)
      S 验证密钥。构成方式请参考创建空间说明 例:md5(update_vhtest3333)
      Name 网站名称
  • 示例

    bash
    URL
    1
    域名:3312/api/?c=whm&a=del_vh&r=3333&s=adasdfasdf2322344&name=webtest

change_password:修改网站密码

  • 接口地址及方法

    • 地址: 域名:3312/api/
    • 方法: GET
  • 参数

    • 固定参数

      参数名 说明 (默认)值
      c 固定 whm
      a 操作名称(固定) change_password
      r 随机数(1000-99999)
      S 验证密钥。构成方式请参考创建空间说明 例:md5(update_vhtest3333)
      Name 网站名称
      passwd 修改的新密码
  • 示例

    bash
    URL
    1
    域名:3312/api/?c=whm&a=change_password&r=3333&s=adasdfasdf2322344&name=webtest&passwd=newpasswd

getVh:获取站点的信息

  • 接口地址及方法

    • 地址: 域名:3312/api/
    • 方法: GET
  • 参数

    • 固定参数

      参数名 说明 (默认)值
      c 固定 whm
      a 操作名称(固定) getVh
      Name 网站名称
  • 示例

    bash
    URL
    1
    域名:3312/api/?c=whm&a=getVh&name=webtest

listVh:获取站点列表

  • 接口地址及方法

    • 地址: 域名:3312/api/
    • 方法: GET
  • 参数

    • 固定参数

      参数名 说明 (默认)值
      c 固定 whm
      a 操作名称(固定) listVh
      r 随机数(1000-99999)
      S 验证密钥。构成方式请参考创建空间说明 例:md5(update_vhtest3333)
  • 示例

    bash
    URL
    1
    域名:3312/api/?c=whm&a=listVh&r=3333&s=adasdfasdf2322344

Test Code

php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
<?php
header("content-type: text/html; charset=utf-8");
$xmls = '<?xml version="1.0" encoding="utf-8"?><add_vh whm_version="1.0"><result status=\'403 sign error\'></result></add_vh>';

$epsafecode = "xCxWDxc4xxxtxdmx";
$rand = rand(1000, 99999);

$domain = "http://103.74.173.19:3312/api/?";

// 所有参数组,带上一个json=1后将返回json字符串

// 增加主机参数
$param = array(
'c' => 'whm',
'a' => 'add_vh',
'r' => $rand,
's' => md5('add_vh'.$epsafecode.$rand),
'Init' => '1',
'name' => 'mytest',
'passwd' => 'test',
'product_id' => 3
);

// 对已有的主机进行套餐升级
$param = array(
'c' => 'whm',
'a' => 'add_vh',
'r' => $rand,
's' => md5('add_vh'.$epsafecode.$rand),
'name' => 'mytest',
'edit' => 1,
'product_id' => 3
);

// 暂停或恢复网站 status = 0 恢复 status = 1 暂停
$param = array(
'c' => 'whm',
'a' => 'update_vh',
'r' => $rand,
's' => md5('update_vh'.$epsafecode.$rand),
'name' => 'mytest',
'status' => 0
);

// 修改网站密码
$param = array(
'c' => 'whm',
'a' => 'change_password',
'r' => $rand,
's' => md5('change_password'.$epsafecode.$rand),
'name' => 'mytest',
'passwd' => '123456'
);

// 删除网站
$param = array(
'c' => 'whm',
'a' => 'del_vh',
'r' => $rand,
's' => md5('del_vh'.$epsafecode.$rand),
'name' => 'mytest',
'json' => 1
);

// 获取服务器信息
$param = array(
'c' => 'whm',
'a' => 'info',
'r' => $rand,
's' => md5('info'.$epsafecode.$rand),
'json' => 1
);

// 获取站点列表
$param = array(
'c' => 'whm',
'a' => 'listVh',
'r' => $rand,
's' => md5('listVh'.$epsafecode.$rand),
'json' => 1
);

// 获取某一站点的信息
$param = array(
'c' => 'whm',
'a' => 'getVh',
'r' => $rand,
's' => md5('getVh'.$epsafecode.$rand),
'name' => 'sumiaomiao',
'json' => 1
);

$param = http_build_query($param);
$url = $domain.$param;
$xmls = file_get_contents($url);
echo '<pre>';
print_r(json_decode($xmls, true));
echo '</pre>';
exit;

$xml =simplexml_load_string($xmls);
$xmljson= json_encode($xml);
$xml=json_decode($xmljson,true);
print_r($xml);
echo $xml['result']['@attributes']['status'];
文章作者: Bill
文章链接: http://blog.webpro.ltd/2018/08/15/easypanel-API-doc/
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 Bill's blog

评论