搬瓦工 KiwiVM 控制面板提供 API 接口,可以通过自己写代码来调用搬瓦工 API。本文分享一下搬瓦工 API 教程,包括怎么获取搬瓦工 API KEY(API 密钥),怎么重置 API KEY,以及获取了 API KEY 之后怎么通过代码进行调用,包括使用 PHP 代码,或者是直接用 wget 和 curl 等工具进行调用。其实调用方法还是很简单的,就是发送个请求,然后返回个结果而已。
搬瓦工获取 API KEY 方法
首先是获取 API KEY,我们可以直接在 KiwiVM 控制面板左侧菜单的 API 选项里进行获取,如图所示。 也可以直接批量导出所有 VPS 的 API KEY。
搬瓦工调用 API 方法
有了 API KEY 和 VEID 之后,就可以进行调用了。
Whether you want to automatically create nightly snapshots, query status of your VPS, or develop a complete replacement for the KiwiVM panel, this page is for you.
To export a csv-formatted list of API keys of all instances under your account, please use our billing portal’s CSV export feature.
All parameters can be passed either via GET or POST methods.
- 无论您是想自动创建夜间快照、查询 VPS 状态,还是开发 KiwiVM 面板的完整替代品,此页面都适合您。
- 要导出您账户下所有实例的 API 密钥的 csv 格式列表,请使用我们的账单门户的 CSV 导出功能。
- 所有参数都可以通过 GET 或 POST 方法传递。
简而言之,只需要向下面地址发送 GET 或者 POST 请求即可:
https://api.64clouds.com/v1/getServiceInfo?veid=YOUR_VEID_HERE&api_key=YOUR_API_KEY_HERE
上面地址中的一些信息需要替换:
getServiceInfo
:可以替换成其他的 API 功能,所有可用接口请参考搬瓦工 KiwiVM 控制面板的 API 页面YOUR_VEID_HERE
:替换成你的 VEIDYOUR_API_KEY_HERE
:替换成你的 API KEY
每个 API 调用都要求您提供 VEID (VPS ID) 和 API 密钥的有效组合,如示例中所示。
每个 API 调用总是返回错误变量。 如果错误不为零,请检查“message”变量以获取有关错误的更多详细信息。
PHP 示例代码和返回结果
下面给出一个 PHP 示例代码,更为直观一些。
PHP 代码获取 VPS 信息:
$request = "https://api.64clouds.com/v1/getServiceInfo?veid=YOUR_VEID_HERE&api_key=YOUR_API_KEY_HERE"; $serviceInfo = json_decode (file_get_contents ($request)); print_r ($serviceInfo);
返回结果如下:
/* ------------------------------- [ output ] ------------------------------- stdClass Object ( [hostname] => my.server.com [node_ip] => 10.20.30.40 [node_alias] => Node32 [node_location] => US, Florida [plan] => micro128 [plan_monthly_data] => 322122547200 [plan_disk] => 4294967296 [plan_ram] => 155189248 [plan_swap] => 37748736 [os] => centos-6-x86_64 [email] => customer@example.com [data_counter] => 569810827 [data_next_reset] => 1430193600 [ip_addresses] => Array ( [0] => 11.22.33.44 [1] => 11.22.33.45 ) [rdns_api_available] => 1 [ptr] => stdClass Object ( [11.22.33.44] => ns1.my.server.com [11.22.33.45] => ns2.my.server.com ) [error] => 0 ) */
这个返回结果可能不是最全的,最新返回结果以实际返回为准,应该会包含更多的信息。
使用 wget 和 curl 调用 API
其实直接使用 wget 或者 curl 命令也可以调用 API,下面做个分享。
使用 wget 调用 API:
wget -qO- "https://api.64clouds.com/v1/restart?veid=YOUR_VEID_HERE&api_key=YOUR_API_KEY_HERE"
使用 curl 调用 API:
//You may want to use curl instead as it allows passing all variables in a POST request $requestData = array ("veid" => YOUR_VEID_HERE, "api_key" => "YOUR_API_KEY_HERE"); $request = "restart"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.64clouds.com/v1/$request"); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); // curl running on Windows has issues with SSL - // see https://kb.ucla.edu/articles/how-do-i-use-curl-in-php-on-windows curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $requestData); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $jsonData = curl_exec($ch); if (curl_error($ch)) die("Connection Error: ".curl_errno($ch)." - ".curl_error($ch)); curl_close($ch); print_r (json_decode ($jsonData));
curl 允许在 POST 请求中传递所有变量,所以可能需要更多设置的话就会用到 curl,不然的话我们使用 wget 即可。
以上就是搬瓦工 API 调用的一些教程,总体还是不难。
搬瓦工优惠/性价比套餐推荐
温馨提醒 如果您有选择困难症,直接选中间的 CN2 GIA-E方案,季付 $49.99,多达 12 个机房任意切换
搬瓦工优惠码:BWH3HYATVBJW,优惠6.58%,全场可用。下面表格整理了更多的搬瓦工优惠套餐。
方案 | 内存 | CPU | 硬盘 | 流量/月 | 带宽 | 机房 | 价格 | 购买 |
---|---|---|---|---|---|---|---|---|
CN2 (最便宜) |
1GB | 1核 | 20GB | 1TB | 1Gbps | DC3 CN2 DC8 ZNET |
$49.99/年 | 购买 |
CN2 | 2GB | 1核 | 40GB | 2TB | 1Gbps | $52.99/半年 $99.99/年 |
购买 | |
CN2 GIA-E (最推荐) |
1GB | 2核 | 20GB | 1TB | 2.5Gbps | DC6 CN2 GIA-E DC9 CN2 GIA 日本软银 JPOS_1 联通荷兰 EUNL_9 |
$49.99/季度 $169.99/年 |
购买 |
CN2 GIA-E | 2GB | 3核 | 40GB | 2TB | 2.5Gbps | $89.99/季度 $299.99/年 |
购买 | |
HK | 2GB | 2核 | 40GB | 0.5TB | 1Gbps | 香港 CN2 GIA | $89.99/月 $899.99/年 |
购买 |
HK | 4GB | 4核 | 80GB | 1TB | 1Gbps | $155.99/月 $1559.99/年 |
购买 |
选择建议:
- 入门:洛杉矶 CN2 套餐,目前最便宜,可选 CN2 GT 机房,入门之选。
- 推荐:洛杉矶 CN2 GIA-E 套餐,价格适中,速度超快,可选机房多,性价比最高。
- 高端:香港 CN2 GIA 套餐,价格较高,但是无可挑剔。