Application

To start leveraging Kii Cloud, you first need to create your application on the developer portal. This will allocate the necessary region for your application and service on Kii Cloud.

You can use the application both from the Kii Cloud SDK and from the Thing-IF SDK.

All data stored in Kii Cloud are segregated per application. Suppose, for example, that Developer A creates "PhotoAlbum" and "CarRacing" applications and Developer B creates "CarRacing" application on Kii Cloud.

  • Kii Cloud will treat all of these applications independently. The "CarRacing" applications made by Developer A and B are treated separately although their names are identical.

  • Kii Cloud allows multiple SDKs to access the same application. For example, Developer A can create his "PhotoAlbum" application for both Android and iOS, and they can share the same data (e.g. sharing photos uploaded by an Android application with an iOS application).

Creating applications

When creating an application, you will specify the following information:

  • Application Name

    The application name is used for identifying your application on the developer portal. The client SDK does not use the application name for identifying the application; instead, it will use the AppID (ref. Access Keys). Multiple applications having the same application name is perfectly ok.

  • Server Location

    Specify the server on which you want to create your application. Kii Cloud servers are currently located in the United States, Japan, China, Singapore, and Europe.

    See Selecting the server for more details.

  • Client SDKs

    Specify the client SDKs you are going to use for the development. The REST API is always available. You can later change this setting, so you can start by selecting the minimum set.

    If you are not going to use any SDK in the selection (e.g., You are going to use Kii Cloud SDK for Thing or REST API), select any SDK here to create your application.

Selecting the server

You need to select the server location when you create a new application. The available server locations are the United States, Japan, China, Singapore, and Europe.

An application uses one fixed server location. When you implement the application, you will specify the server location in a parameter passed to the initialization API.

Each application is independent. Two applications do not share the data even if they have the same name. You cannot change the server location after you create it.

Selecting the server location

We advise you to select the nearest server location from where your application will be used. The "nearest" here means both physically and network-topologically.

One useful tip for finding the nearest server location in network-wise is to check the response time by executing the following command. You can execute the command several times to calculate the average response time and determine the best server location.

time curl -v -X GET "https://api.kii.com/"

Please change the access URL to change the server location to check.

  • United States: https://api.kii.com/
  • Japan: https://api-jp.kii.com/
  • China: https://api-cn3.kii.com/
  • Singapore: https://api-sg.kii.com/
  • Europe: https://api-eu.kii.com/

You will get a "404 Not Found" HTTP response by executing the command, but you will also get the time the response time to the server.

The client SDKs and REST API also access to the above URLs. If you encounter a network error on your device, you can use the above command to check if the target server is down or not.

Available features on each server location

Although all basic Kii Cloud features are available on all of the server locations, some features are not available on certain server locations.

Please check the table below for the available features on each server locations.

US Japan China Singapore Europe
Push notification with FCM Yes Yes Yes Yes
Integration with Facebook, Twitter, Google, and Dropbox Yes Yes Yes Yes
Integration with d ACCOUNT and PhotoColle SDK Yes
Other features Yes Yes Yes Yes Yes