Call Back API

Callback is an authentication method in which the user verifies their identity via a voice call. This method provides an additional level of security, as the code is delivered verbally, making it difficult for attackers to intercept or guess.

Sending a Call Back request

Request:

POST api.unibell.ru/apps/flash/calls/flash

Data is passed in the request body:

{
   "reference": "e0965a38ef9c72d8156d3a157a8a50d0",
   "sourceAddr": "7XXXXXXXXXX",
   "destAddr": "7XXXXXXXXXX",
   "code": "123456"   
}

Parameter	Description
reference (необязательный параметр)	Request identifier, which will later be returned in the status. Used for tracking requests in the client’s system
sourceAddr	Phone number from which the call is made, in e.164 format for the Russian Federation (7XXXXXXXXXX) *The field must not contain Cyrillic characters*
destAddr	Client service phone number that the subscriber will call, in e.164 format for the Russian Federation (7XXXXXXXXXX)
code	Code that will be spoken during the call

Response:

{
   "status": "ok",
   "requestId": "93d91390d7c0b1f8de9d4cd0d7f6ea52"
}

Parameter	Description
status	Request status
requestId	Unique request identifier on the partner’s side

In case of an error in sourceAddr:

{
    "status": "invalidDataError",
    "error": "Field sourceAddr must not contain Cyrillic"
}

Parameter	Type	Description
status	string	Request status
error	string	The sourceAddr field must not contain Cyrillic characters

After the request is sent, the subscriber must call the specified client number. If the code is found, the IVR will announce it. Otherwise, the message “Your code was not found” will be played. The code will be available for 5 minutes and will then be deleted if it has not been requested.

On this page