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 RumbleTalk admin account, follow these steps:

  1. Login to your RumbleTalk account.
  2. Go to the upper-right corner and click "Account Settings".
  3. Navigate to the "Integration" tab to find the Key & Secret.
  4. Make sure to click "Show token secret" button and enter your your RumbleTalk admin password for security purposes.
  5. After submitting the correct password, the secret key will become readable, enabling you to copy you Key and Secret.

Once you have your Key and Secret, you can use them to obtain an access token.

This token allows you to do perform various types 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>" }