How can we help?
How to use iCafeCloud API
We have added an API feature for iCafeCloud. You generate your API key and secret from the Cloud panel “Settings” page API Settings (Figure 1).
- To create your API key and API Secret, click the “Create” button (Figure 2).
- It will create the 2 keys “API keys” and “API Secret” (Figure 3).
- Click the “Copy” button next to copy the keys (Figure 4).
- Paste the keys along with “License ID” to a text file and save it (Figure 5).
Note: Please note that API Secret will only be displayed once when you create it. If you forget to copy it or don’t save it. Then, you need to create the keys again to get the API Secret.
- Now, download our example file from this link to your server or your web application.
- Edit the example file and replace the placeholders with your “License ID”, “API Keys” and “API Secret” (Figure 6).
- Remove any “vardump” in the example file and then you are ready to use the API.
- Note the parameters used in the example file (Figure 7)
- And create a web form using any frontend framework or just plain HTML/CSS/JS (Figure 8)
Note: The fields with * are required fields to create a member account using the API so those must be included in the form.
- When you submit the form, if the account create succeeds the response from the API will be ‘true’ or “”., and if the member already exists then you will receive “Account exists” as a response (Figure 9)
- Using the response, you can show alerts or perform other actions using javascript (like showing sweet alerts) (Figure 10)
Notes:
- Current API only supports creating member accounts, other features and functions will be added in the future.
<!-- wp:paragraph -->
<p><?php</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>/***</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * access icafecloud's api</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * @param $params</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * array(</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_account: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_password: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_first_name: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_last_name: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_birthday: 'yyyy-mm-dd',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_expire_time_local: 'yyyy-mm-dd'</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_email: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_phone: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_id_card: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_balance: 0,</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_points: 0,</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_group_name: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_sex: 'F/M',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_comments: '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> member_address: ''</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * )</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * @param $method string POST|GET|DELETE|PUT</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * @param $api_key string</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * @param $api_secret string</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * @param $error string return error message</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> * @return bool true|false</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> */</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>function icafecloud_api_execute($end_point, $params, $method, $license_id, $api_key, $api_secret, &$error)</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>{</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $curl = curl_init();</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_VERBOSE, false);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $query = http_build_query($params, '', '&');</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $time = time();</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $signature = $license_id . "\x00" . $api_key . "\x00" . $time . "\x00" . strtoupper($method) . "\x00" . $query;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $signhash = hash_hmac('sha256', $signature, $api_secret);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $headers = array(</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> "X-Time: {$time}",</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> "X-License-Id: {$license_id}",</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> "X-Auth: {$api_key}:{$signhash}"</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> );</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_URL, 'https://cp.icafecloud.com/api/v1/' . $end_point);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_USERAGENT, "User-Agent: Mozilla/4.0 (compatible; PHP iCafeCloud API)");</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> // Post and postfields</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> if ($method === "POST") {</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_POST, true);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_POSTFIELDS, $params);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> }</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> // Delete Method</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> if ($method === "DELETE") {</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> }</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> // PUT Method</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> if ($method === "PUT") {</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_PUT, true);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> }</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_HEADER, true);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_setopt($curl, CURLOPT_TIMEOUT, 60);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $output = curl_exec($curl);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> var_dump($output);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> // Check if any error occurred</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> if (curl_errno($curl) > 0) {</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $error = 'Curl error: ' . curl_error($curl);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> return false;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> }</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $http_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> if ($http_code != 200) {</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $error = "Curl status is " . $http_code;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> return false;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> }</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $header_size = curl_getinfo($curl, CURLINFO_HEADER_SIZE);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $output = substr($output, $header_size);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> curl_close($curl);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $ret_data = json_decode($output, true);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> if ($ret_data === false) {</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $error = 'Invalid response';</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> return false;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> }</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $result = $ret_data['result'] ?? 0;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> if ($result == 0) {</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> $error = $ret_data['message'] ?? '';</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> return false;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> }</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> return true;</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>}</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p># tests</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>$params = [</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_account' => 'test01',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_password' => '123456',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_first_name' => 'Robert',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_last_name' => 'Wood',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_birthday' => '1999-01-01',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_expire_time_local' => '0000-00-00',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_email' => '[email protected]',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_phone' => '13000000001',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_id_card' => 'ID-231302',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_balance' => 0,</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_points' => 0,</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_group_name' => '',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_sex' => 'M',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_comments' => 'created by api',</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p> 'member_address' => '12621 Frank Loyd'</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>];</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p># generate your api key/secret in CP settings</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>$license_id = '<your license id>';</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>$api_key = '<your api key>';</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>$api_secret = '<your api secret>';</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>$ret = icafecloud_api_execute('member', $params, 'POST', $license_id, $api_key, $api_secret, $error);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>var_dump($ret);</p>
<!-- /wp:paragraph -->
<!-- wp:paragraph -->
<p>var_dump($error);</p>
<!-- /wp:paragraph -->