Integration - API

Kiwire has a built in API (Application Protocol Interface) that let your application connect and manipulate system and retrieve data from your own developed application. For optional reading, Technical information on the Kiwire API specification will be included below. To access the API module click on Integrations > API from the navigation. The configuration screen will be displayed. This includes main and permission for Kiwire platform.

The field and its function description is listed below.

API Permission

The API permission tab enables you to configure the API permission given to the connecting application. Use “toggle” to enable the permission of the API interface to 3rd party.

The field and its function description is listed below.

<h3><strong>Supported Modules</strong></h3>

<p>Currently, Kiwire supports API for the following modules :</p>

• Admin user

• NAS

• Devices

• Profile

• Login

• User

• Voucher

General Result

Every API request send to Kiwire will be respond as a JSON object with the below structure;

• is_success – boolean (always true)

• result_msg – string (message generated as a result of a request)

• ret_data – array (items for get method)

Additionally, Kiwire also will respond with an error message based on the below structure;

• error – string (error message)

API Login

Every API request needs to perform login to obtain token key which then will be used to make request to module.

URL - http://{{kiwire_ip}}/admin/agent/api_login.php

Parameters Required

Response

{
"status": "success",
"token": "80d588720c2203739ad643d405e63136"
}

Notes

This action will create an API session inside Kiwire which expires after 20 minutes. You have to re-login after 20 minutes to make another API request.

The token provided will be use in all API request.

Module: Login

URL

[POST] http://{{kiwire_ip}}/apiv2/login/{{method}}/{{value}}

Where {{method}} can be:

• history : List of sessions created for particular account

• online : Send request to NAS for login user device as per account provided

• unauthorize : List of user device which are not authorised

Where {{value}} can be:

• username : For history method

• nas id : For unauthorize method

Parameters Required

History - List of sessions created for particular account

*If username is not provided in this request, the session list for all user will be returned.

Online - Send request to NAS for login user device as per account provided

*Parameters marked as optional will only be used if user creation required (user not existed). If these values are not provided during the creation process, default value will be used as per below;

Unauthorize - List of user device which are not authorized

Response

{
“is_success” : “true”, // always true to indicate that the request has been processed
“result_message” : “”, // return a string of status for online method
“return_data” : [] // return items found in database for unauthorize and history
}

Module: Administrator User

URL [POST] http://{{kiwire_ip}}/apiv2/admin/{{method}}/{{value}}

Where {{method}} can be:

• create

• delete

• get

Where {{value}} can be: administrator

• username

Parameters Required

Create

Delete

Get

Notes

For get method, if {{value}} not provided then Kiwire will return all available items subject to start and limit.

Module: User Account

URL

[POST] http://{{kiwire_ip}}/apiv2/user/{{method}}/{{value}}

Where {{method}} can be:

• create

• delete

• get

Where {{value}} can be:

• user account

Parameters Required

Create

Delete

Get

Notes

For get method, if {{value}} not provided then Kiwire will return all available items subject to start and limit.

Module: NAS

URL

[POST] http://{{kiwire_ip}}/apiv2/nas/{{method}}/{{value}}

Where {{method}} can be:

• create

• delete

• get

Where {{value}} can be:

• nas identity

Parameters Required

Create

Delete

Get

Notes

For get method, if {{value}} not provided then Kiwire will return all available items subject to start and limit.

Module: Devices

URL

[POST] http://{{kiwire_ip}}/apiv2/device/{{method}}/{{value}}

Where {{method}} can be:

• create

• delete

• get

Where {{value}} can be:

• voucher code

Parameters Required

Create

Delete

Get

Notes

For get method, if {{value}} not provided then Kiwire will return all available items subject to start and limit.

Module: Profile

URL

[POST] http://{{kiwire_ip}}/apiv2/profile/{{method}}/{{value}}

Where {{method}} can be:

• create

• delete

• get

Where {{value}} can be:

• profile name

Parameters Required

Create

Delete

Get

Notes

For get method, if {{value}} not provided then Kiwire will return all available items subject to start and limit.

Sample API Code

<?php
session_start();
// Configuration
$cloud_id = "default";
$username = "admin";
$password = "youradminpassword";
$api_key = "Nsf7a86787asvh&5asfkasdfNDJFNKsa=sS"; // API key get from Kiwire
$kiwire_host = "http://kiwireserveraddress.com";
$kiwire_port = 8081;
/* *********************
** -- START --
** LOGIN & TOKEN PART
*/
// If token already exist, check if the token expired or not
if(isset($_SESSION['login_token']) && isset($_SESSION['login_last_time'])){
$time_current = time();
$time_login_expired = strtotime("+20 minutes", $_SESSION['login_last_time']);
if($time_current < $time_login_expired) $do_not_get_token = true;
}
// If token not exist or token expired, get new token
if(empty($do_not_get_token)){
// setup api_login method to get the token
$login_api_data = Array(
"url" => $kiwire_host . "/admin/agent/api_login.php",
"port" => $kiwire_port,
"params" => Array(
"code" => MD5( $username . "|" . $password ),
"cloud_id" => $cloud_id,
),
);
// execute api_login method to get the token
$result_json = sendhttpreq($login_api_data['url'], $login_api_data['params'], "POST", $login_api_data['port']);
$result_array = json_decode($result_json, true);
$_SESSION['login_token'] = $result_array['token']; //the token will expired in 20 minutes and must renew the token each 20 minutes
$_SESSION['login_last_time']= time();
}

/*
** -- END --
** LOGIN & TOKEN PART
** ********************* */
// this $current_datetime variable
// must be included in the hashed API Key ( MD5($real_api_key . $login_token . $current_datetime) )
// also must be included in params as "time"
// - refer the code below
$current_datetime = date("YmdHis");
// set up login history method
// you can refer to documentation for another method
$api_call_data = Array(
"url" => $kiwire_host . "/apiv2/login/history",
"port" => $kiwire_port,
"params" => Array(
"start_time" => "2017-06-08 00:00:00",
"end_time" => "2017-06-08 23:59:59",
"token" => $_SESSION['login_token'],
"api_key" => MD5( $api_key . $_SESSION['login_token'] . $current_datetime ),
"time" => $current_datetime,
"cloud_id" => $cloud_id,
),
);

// execute login history method
$result_json = sendhttpreq($api_call_data['url'], $api_call_data['params'], "POST", $api_call_data['port']);
$result_array = json_decode($result_json, true);

// if login token expired, refresh to get new token
if(substr($result_array['error'], 0, 13) == "login expired"){
session_destroy();
echo "<script>window.location.reload();</script>";
}

// display the result
var_dump($result_array);

// Function for sending HTTP Request
function sendhttpreq($url, $data, $method="GET", $port=80){
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_PORT, $port);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
return $result;
}
?>

List of Error Message