Readme.io has a nice feature to try an API on the right panel. Here we take the example of Smart Home APIs to show you how to try our APIs in readme.io:
- Most of APIs require Bear token for authentication
- You need to first try Agent login API to get a token
- When you try other API, copy this token into Bear area on the top of right panel
Get Bear authentication token
The following are a list of steps to get Bear token:
-
Select Agent → Login API from left menu.
-
In middle section, Under BODY PARAMS:
-
You will get grant_type is having default value as ‘password’.
-
Type to fill up value for username.
-
Type to fill up value for password.
-
-
After doing above mention things, in Right section, you will see Request Example is formed as:

-
Now click on ‘Try It!’ button.
-
You will get the result of request in Response Example as:

- Copy the “access_token” value from Response to use it for other APIs example.
Example: Try List of Properties API
Here we show an example how to use the token you obtained from Auth Login API. The following are steps:
-
Select Properties → List of Properties API from left menu.
-
Put copied access_token value in Authentication section for Bearer token under right menu.

- Now click on ‘Try It!’ button. Below is what it looks like in Reademe right panel:

- You will get the result of request in Response Example as shown below

