Authentication Instructions
Global API URL: https://global-api.fintechstudios.com Authorization API Endpoint: "/auth/login"
Using the Global API URL combined with the Authorization Endpoint, take the Email, Password, and API Key from the FinTech Studios API Settings. Format the payload and headers as follows:
Payload:
{
"email": "{email address}",
"password": "{password}"
}
Headers:
{
"x-api-key": "{API Key}",
"Content-Type": "application/json",
}
The response will be a JSON structure as follows:
{
"token": "{Security Token}",
"expires": 1755055347000,
"userId": "{user ID}",
"tenantId": "fintechcloud"
}
Token Processing
Once the authentication has been done, you will have a security token that should be managed. You don't need to log in every time you want to hit an endpoint. You just need to provide the security token as part of the headers when you make an API endpoint call. Part of the json is an expiration date/time stamp that can be used to determine when you next need to authenticate again. Save the security token and use it until it is expired. Once it has expired, authenticate the API again and capture a new security token.
userId Processing
The User ID you get back in the userId field needs to be saved as well. This field will be used in several of the endpoints to retrieve data or update a channel. Make sure you save the User ID and the Security Token as part of the authentication process.
Subsequent API Authentication
Every endpoint you use after authentication needs the headers to be set up this way:
{
"x-api-key": "{api_key}",
"Authorization": "{security token}",
"Content-Type": "application/json",
}