REST API Quick Start

Authentication

Whether your REST requests need to be authenticated or not depends on your channel's authentication settings. If you are unsure whether to authenticate or not, we recommend using the Basic Authorization header for all REST requests.

Sending messages

Rooms are used to isolate different message types. To listen to messages, you need to subscribe to a specific room. Users can freely connect to multiple rooms (this does not create extra connections).

POST https://api2.scaledrone.com/[channel_id]/[room_name]/publish
Body: {"hello": "from REST"}

You can use cURL to try it out:

curl -H "Content-Type: application/json" \
 -X POST \
 -d 'Hello from Scaledrone' \
 https://api2.scaledrone.com/CHANNEL_ID/ROOM_NAME/publish