AuthTOTP
Verify TOTP code and complete the login process. This endpoint is used after initial login when TOTP is required.
Temporary token received from initial login
eyJ0eXA...TOTP verification code
123456The TOTP verification was successful and login is completed.
Required field(s) are missing, data is invalid, or the action is not allowed.
Unauthorized Access
Forbidden
POST /api/v1/auth/totp/verify/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"temp_token": "eyJ0eXA...",
"token": "123456"
}{
"key": "a46ba..."
}Setup TOTP authentication.
The TOTP setup was successful.
Required field(s) are missing, data is invalid, or the action is not allowed.
Forbidden
POST /api/v1/auth/totp/setup/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
"secret_key": "RE4U7XXXXXXXXXXXX",
"provisioning_uri": "otpauth://totp/Omnitron%3Aakinon?secret=RE4U7XXXXXXXXXXXX&algorithm=SHA1&digits=6&period=30&issuer=Omnitron"
}Activate TOTP authentication by verifying the TOTP code.
TOTP verification code
123456The TOTP activation was successful.
Required field(s) are missing, data is invalid, or the action is not allowed.
Forbidden
POST /api/v1/auth/totp/activate/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"token": "123456"
}{
"recovery_codes": [
"ABCD1234"
]
}Deactivate TOTP authentication for the current user.
The TOTP deactivation was successful.
No content
Required field(s) are missing, data is invalid, or the action is not allowed.
Forbidden
POST /api/v1/auth/totp/deactivate/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
No content
Was this helpful?