Step 1: Get a REX account

If you don't have a REX account yet, please go to our registration page and create a new free account.

If you already have a REX account, please sign in with your credentials.

Login screen of REX.

Once your registered for a new account, you should receive an activation email. Please confirm the account creation by clicking the link in the email. After account creation, you should already have the REX freemium license.

Step 2: Getting an API key

In order to access rexOS as a developer, you need to generate an API key. This can easily be done by getting into Settings.

Open settings in your menubar after successfully logged in.

From within Settings you are able to generate a new token. Assign a name for the new token (e.g. tutorial), and press the checkbox to the right.

You can easily generate a new token.

A new API token has been generated by rexOS. Please make sure to save the ID and the Secret.

The secret will not be visible afterwards. So please make sure to store it safely.

Please make sure to store your generated clientId and clientSecret.

You are now ready to start with your first API call.

Step 3: Test connection to rexOS

In order to test the connection to rexOS you can use any web client (e.g. curl for command line or Insomnia for a graphical tool). Just replace the clientId and clientSecret with your generated credentials, and execute the command on the command line.

$ curl 'https://rex.robotic-eyes.com/oauth/token' -i -u '<clientId>:<clientSecret>' -X POST \
    -H 'Accept: application/json;charset=UTF-8' \
    -H 'Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1' \
    -d 'grant_type=client_credentials'

You should get a valid HTTP response with code 200 looking something like:

HTTP/2 200
content-type: application/json;charset=UTF-8

The response also contains a JSON payload which gives your the actual access token for sub-sequent calls.

{
    "access_token":"<your_access_token",
    "token_type":"bearer",
    "expires_in":599,
    "scope":"API",
    "user_id":"<your_user_id>",
    "user_name":"<your_user_name>",
    "jti":"hidden"
}

Continue by installing the REXview mobile app Next