Get started with the KEKO platform (KEPPI)

Overview

This instruction provides basic know-how related to the access to KEPPI platform and helps to get started with it. Keko Platform is an experimentation platform for API development, read more about the platform here. Before you start using KEPPI, you need to have an access token. The token is a unique identifier that is used in authenticating requests related to your project.

Get access to KEKO experimentation platform (KEPPI)

We are accepting BETA developers to the KEKO development program. In order to access public KEKO APIs, you need a token to authenticate your requests. In order to bring your own data or refine existing data to create new APIs, you need KEKO platform credentials.

To get the token or credentials:

  1. Join our slack to get in touch with us.
  2. Define your case: what would you like to do and what kind of access you would like to get.
  3. We will grant you the right level of access to the platform and test data, either credentials or token.

Access APIs with your token

You need to include an API token in the HTTPS request – either GET or POST as specified in the respective API document. In the following example, replace “{API_TOKEN}” with your API token you have received.

On linux, you can use cURL to create a sample GET request to the KEKO platform:

curl https://keko.whereos.com/api/bim/ids \
-H “Accept: application/json” \
-H “Authorization: Bearer {API_TOKEN}”

List the building ids and get more information

List of building ids that you have access to with your token.

curl https://keko.whereos.com/api/bim/ids \
-H “Accept: application/json” \
-H “Authorization: Bearer {API_TOKEN}”

List the floors for your building ID

curl https://keko.whereos.com/api/bim/areas/{building_id} \
-H “Accept: application/json” \
-H “Authorization: Bearer {API_TOKEN}”

Get floor plan for a specified floor

curl -o my_local_file.pdf \
https://keko.whereos.com/api/bim/floorplan/{building_id}/{area_id}?format=pdf \
-H “Accept: application/json” \
-H “Authorization: Bearer {API_TOKEN}”

List sensored resources in a building

curl https://keko.whereos.com/api/environmental/sensors/{building_id} \
-H “Accept: application/json” \
-H “Authorization: Bearer {API_TOKEN}”

Get temperature reading for a specified resource (must be one of the resources listed in the /environmental/sensors call):

curl https://keko.whereos.com/api/environmental/temperature/{building_id}/{resource_id} \
-H “Accept: application/json” \
-H “Authorization: Bearer {API_TOKEN}”

Please refer to KEKO API listing for more details about the APIs, their parameters and return values

More Information

Bring your own data sources to KEKO

A list of existing and upcoming APIs