Indoona Open API - Version 0.9.5

The indoona Open API is implemented as a set of HTTP RESTful calls, which return JSON-formatted data.

Each request must be authorized by an OAuth2 token included in the Authorization header.

E.g. Authorization: Bearer f66907b18c304d9a226cbbe1c128c8164e19ff01

Such token can be either:

  • an application-level token: associated to OAuth2 credentials obtained at App Creation stage;
  • a user-level token: obtained through an OAuth2 authorization code for a specific user at user connection stage.

When using the former type of token to perform a request on behalf of a specific connected user, the user_id parameter must be added to the request.

OAuth API

API Name Description
token Returns an OAuth2 access token

User-level API

API Name Description
me Returns information about the connected user
contact/add Adds a contact to the address book of an indoona user
contact/remove Removes a contact from the address book of an indoona user
contact/list Returns all contacts in the address book of an indoona user
resource/info Returns the information associated to an indoona resource
resource/list Returns the resource list of a connected user
resource/leave Returns the operation’s boolean outcome
message/send Sends a message to an indoona resource
user/disconnect Disconnects a connected user

App-level API

API Name Description
otp/verify Verifies an otp (one time password) delivered to a user by the indoona platform
app/contact/create Creates a new contact on behalf of the app itself
app/contact/modify Modifies a contact on behalf of the app itself
bulk/contact/add Adds a contact to the address book of each user in a specified list
bulk/contact/remove Removes a contact from the address book of each user in a specified list
bulk/message/send Sends a message to a list of indoona resources