搬瓦工 API 教程：获取 API KEY/调用 API 方法/PHP 示例代码

搬瓦工 KiwiVM 控制面板提供 API 接口，可以通过自己写代码来调用搬瓦工 API。本文分享一下搬瓦工 API 教程，包括怎么获取搬瓦工 API KEY（API 密钥），怎么重置 API KEY，以及获取了 API KEY 之后怎么通过代码进行调用，包括使用 PHP 代码，或者是直接用 wget 和 curl 等工具进行调用。其实调用方法还是很简单的，就是发送个请求，然后返回个结果而已。

一、搬瓦工获取 API KEY 方法

首先是获取 API KEY，我们可以直接在 KiwiVM 控制面板左侧菜单的 API 选项里进行获取，如图所示。

二、搬瓦工调用 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：替换成你的 VEID
• YOUR_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 套餐，目前最便宜，可选 CN2 GT 机房，入门之选。
• 推荐：洛杉矶 CN2 GIA-E 套餐，速度超快，可选机房多（DC6、DC9、日本软银、荷兰联通等），性价比最高。
• 高端：香港 CN2 GIA 套餐，价格较高，但是无可挑剔。