Authentication of RumbleTalk's RESTful API

To start using the RumbleTalk REST API, you must first authenticate your requests. RumbleTalk REST API offers two types of authentications:

  1. Single account holders
  2. Enterprise accounts and third parties

Note: all access tokens have an expiration date accessible in the exp parameter. Depends on the token, the duration can vary from 1 hour, 1 day, to even 1 month.
Read more about it on jwt.io


For single account holders

If you're simply trying to control your group chats from within your website, app, or any software you own, this is the option for you.

To get the key and secret of your account, follow these steps:

  1. Login to your RumbleTalk account
  2. Click on "My Account"
  3. Copy your Key and Secret
    * If your Key and Secret are empty, click on "Generate new token".

Once you have your key and secret, you can use them to get an access token. With that token you can perform different type of requests, such as creating a chat room, or banning an IP address.

Getting an access token

POST
https://api.rumbletalk.com/token

Request format

  • Parameter
  • Type
  • Description
  • key
  • string
  • Your app key
  • secret
  • string
  • Your app secret

cURL example

curl \ -X POST \ "https://api.rumbletalk.com/token" \ -d "{\"key\":\"<your key>\",\"secret\":\"<your secret>\"}"

Response example

{ "status": true, "token": "<your token>" }

Third parties and enterprise accounts

This method of authentication is useful if you manage more than one account. It gives full control over every account that is associated with your app.

To start using this type of authentication, and get your key and secret, please contact us at: support@rumbletalk.com and ask for the API key and secret for an enterprise account.

Getting an access token

POST
https://api.rumbletalk.com/parent/token

Request format

  • Parameter
  • Type
  • Description
  • key
  • string
  • Your app key
  • secret
  • string
  • Your app secret

cURL example

curl \ -X POST \ "https://api.rumbletalk.com/parent/token" \ -d "{\"key\":\"<your key>\",\"secret\":\"<your secret>\"}"

Response example

{ "status": true, "token": "<your token>" }