Welcome! Here you will have access to all the resources necessary to build an application successfully.

At its core, Tata Cloud Telephony uses JWTs to provide RESTful access to its resources.

Here are some specific resources and guides to get you started in a jiffy!

📘
About Access Tokens

Permanent Access Token: You need to contact Tata cloud telephony support for unlimited access token.

Short-Lived Token: Herein, you can access a 1-hour valid token using server-side JWT assertion.

Note: The token does not contain any information about the user and only contains authorization information for running an API.

Requesting a Token

You can request the token in the following manner:

curl --request POST \
  --url https://api-smartflo.tatateleservices.com/v1/auth/login \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"email":"email@example.com","password":"password"}'

The below video illustrates the token fetching mechanism to get a short-lived token.

Let's understand the Request and Response Variables in detail.

Request Variables (Body Params)

You can retrieve the access token by entering the below-mentioned values in the Request Variables:

Variable	Description	Data Type
email	The login ID of the client.	String
password	The password of the client.	String

Response Variables

When the Request Variables are parsed, you will get Response Variables in return. They will contain the unique access token which can be used for running an API.
The response variables are as following:

Variables	Description	Data Type
success	The token generate status.	Boolean
access_token	The generated access token. Copy this code and use it in all your APIs which ask for authorization.	String
token_type	The type of the token generated.	String
expires_in	The time for which the token is valid.	Number

Using the API Token

Once you have the access token, refer to the video to learn how to run an API using the token.

Refreshing a Token

The short-lived tokens have a lifetime of 60 minutes, after which you will have to request a refresh token, like in the example shown below.

curl --request POST \
  --url https://api-smartflo.tatateleservices.com/v1/auth/refresh \
  --header 'Accept: application/json' \
  --header 'Authorization: yourtokengoeshere'