1

Login

Interact Developer accounts are currently invitation-only. If you’d like to be registered for an account, please send a request from your corporate email.

2

Get your credentials

You need the following credentials to use the APIs in your application:

  • System Credentials are part of an Interact System installation. If you don’t have access to one, you’ll still be able to use the API playground in API Docs to test the calls.
  • App Credentials are generated for individual apps by adding them in My Apps.
3

Send your first requests

Create an access token

Request

Use the Authorization API (login required) to form a token request.

curl -X POST   https://api.interact-lighting.com/oauth/accesstoken   
	-H 'authorization: Basic your-system-credentials' 
	-H 'content-type: application/x-www-form-urlencoded' 
	-d ‘app_key=your-app-key&app_secret=your-app-secret&service=service

authorization: Use your System Credentials from step 2 to create the authorization header. Combine the username and password as “username:password”, then Base64 encode the string. Prepend the authorization method “Basic” to the encoded string:

authorization: Basic Base64Encode("username:password")

app_key, app_secret: App Credentials generated when you add an app in My Apps
service: The service is determined by the API and system you are using and can be found on the related documentation pages, ex. officeCloud

Response

{"token" : "your-access-token"}

 

Use the access token to make an API call

Request

Use Get sites (login required) to request a list of building sites.

curl -X GET https://api.interact-lighting.com/interact/api/officeCloud/v1/sites   
	-H 'authorization: Bearer your-access-token'    
	-H 'content-type: application/json'

Sample Response

[
    {
        "uuid": "aa2b351c-6627-4624-befe-e946a865ed13",
        "name": "Barcelona"
    },
    {
        "uuid": "34ef52fe-e39f-4c77-9d33-02c291aefda5",
        "name": "Eindhoven"
    }
]

Learn more

You can use the following resources to learn more about and explore Interact APIs:

  • API docs provides detailed documentation and a playground to send test calls
  • Examples describes example applications that leverage the APIs

In you have any questions or comments, please contact us.

Improve your experience

It looks like you are using undefined undefined. This browser isn’t supported and may result in reduced functionality on this site. To improve your experience, try one of these popular browsers:

Google Chrome
Version 54+
Mozilla Firefox
Version 50+
Microsoft Edge
Version 14+
Apple Safari
Version 9+