Initialize JWT Token

Initialize a new Authentication Token

POST /api/token

This endpoint creates a temporary JWT token to authenticate the Taiki client CDK. It expires in 1 hour for security reasons.

Your application should store the taiki_user_id for each unique client on your end. In future years, when you Initialize the JWT token, provide the taiki_user_id and Taiki will retrieve the prior year used platforms and documents connected to the taiki_user_id.

Modes

The JWT token will incorporate which of the two Modes/Base Urls you are using. Just Invoke the Taiki App with the JWT token and the app will automatically use that mode.

Headers

Name	Value	Description
Content-Type	application/json	The content type returned.

Body

Name	Type	Description
api_key	string	The valid UUID provided upon ClientApp creation. get the api_key
api_secret	string	Secret key of your application. (This field can be regenerated via the dashboard).
taiki_user_id	string	Optional Taiki user ID. A new user will be created if this field is not present.

Response

200

{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzI4MjkzNDY0LCJpYXQiOjE3MjQ2OTM0NjQsImp0aSI6ImI3OTgzMjQwNTE4YzRjNTI4Y2UyZGI0ZWNjMjgwMWU0IiwiY2xpZW50X2FwcF9pZCI6IjA2NmNjYjhiLWEyZGYtNzg1MS04MDAwLWRjNDEzYWNlODcyZSIsInRhaWtpX3VzZXJfaWQiOiIwNjZjY2JiZC04ODI0LTc3ZTMtODAwMC0wZGI5YThlMDUwNjcifQ.S2-kuFx-P4JTpyuOszDz_gXRLCHj0EKpUvUft9n3me0",
    "taiki_user_id": "066ccbbd-8824-77e3-8000-0db9a8e05067"
}

Name	Type	Description
access_token	string	Temporary access token
taiki_user_id	string	Taiki's internal user ID to associate the user to their credentials

400

{
    "error": "invalid_request",
    "error_description": "No API key or API secret provided"
}

401

{
    "error": "invalid_client",
    "error_description": "Incorrect API key, API secret, or Taiki user ID provided"
}