{"id":3515,"date":"2026-01-13T12:03:14","date_gmt":"2026-01-13T09:03:14","guid":{"rendered":"https:\/\/docs.unibell.tech\/?page_id=3515"},"modified":"2026-01-15T17:20:47","modified_gmt":"2026-01-15T14:20:47","slug":"flash%d1%81all-api","status":"publish","type":"page","link":"https:\/\/docs.unibell.tech\/?page_id=3515","title":{"rendered":"Flash\u0421all API"},"content":{"rendered":"\n<p>Flash Call is a modern authentication technology that uses an incoming call to verify the user\u2019s identity. Unlike standard SMS codes, Flash Call allows for a faster and more convenient verification process.<\/p>\n\n\n\n<h2 id=\"flashcall-requests\" class=\"anchor\">FlashCall requests<\/h2>\n\n\n\n<p style=\"font-size:15px\"><strong>Request:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>POST https:\/\/api.unibell.ru\/apps\/flash\/calls\/flash?X-Authorization=AccessKey d8ac9959r12b43545XXXXX<\/code><\/pre>\n\n\n\n<p style=\"font-size:15px\"><strong>Parameters are passed in the request body:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n   \"number\": \"XXXXXXXXXXXX\",\n   \"code\": 1234,\n   \"timeout\": 60000\n}<\/code><\/pre>\n\n\n\n<p><strong>Example requests using CURL:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl --location 'https:\/\/api.unibell.ru\/apps\/flash\/calls\/flash?X-Authorization=AccessKey%20d8ac9959r12b43545XXXXX' \\\n--header 'Content-Type: application\/json' \\\n--data '{\n   \"number\": \"XXXXXXXXXXXX\",\n   \"code\": 1234,\n   \"timeout\": 60000\n} '<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>curl --location 'https:\/\/api.unibell.ru\/apps\/flash\/calls\/flash' \\\n--header 'X-Authorization: AccessKey d8ac9959r12b43545XXXXX' \\\n--header 'Content-Type: application\/json' \\\n--data '{\n   \"number\": \"XXXXXXXXXXXX\",\n   \"code\": 1234,\n   \"timeout\": 60000\n} '<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Parameter<\/strong><\/th><th><strong>Description<\/strong><\/th><\/tr><\/thead><tbody><tr><td>number<\/td><td>Phone number in e.164 format<br><strong><em>The field must not contain Cyrillic characters<\/em><\/strong><\/td><\/tr><tr><td>code<\/td><td>4-digit code<\/td><\/tr><tr><td>timeout<\/td><td>Maximum call duration in milliseconds<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Response:<\/strong><\/p>\n\n\n\n<p style=\"font-size:15px\">In case of successful sending, a <code>requestId<\/code> is returned \u2013 the message identifier on the partner\u2019s side, which is later returned in the callback.<\/p>\n\n\n\n<p><strong>Example of a successful response:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{        \n   \"requestId\": XXXXXX\n   \"from\": \"XXXXXXXXXXXX\"\n}<\/code><\/pre>\n\n\n\n<p><strong>Example of an unsuccessful response:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n   \"errorCode\" : 1,\n   \"errorReason\" : \"Authentication required\"\n}<\/code><\/pre>\n\n\n\n<h2 id=\"status-error-codes\" class=\"anchor\">Error code descriptions<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>errorCode<\/strong><\/th><th><strong>errorReason<\/strong><\/th><th><strong>Description<\/strong><\/th><\/tr><\/thead><tbody><tr><td>1 \u041d\u0422\u0422P 401<\/td><td>Authentication required<\/td><td>Invalid authentication token<\/td><\/tr><tr><td>2 HTTP 400<\/td><td>Inactive account<\/td><td>Inactive account. Contact support<\/td><\/tr><tr><td>4 HTTP 429<\/td><td>Too many requests<\/td><td>Too many requests in a short period<\/td><\/tr><tr><td>5 HTTP 401<\/td><td>Inactive token<\/td><td>Inactive token<\/td><\/tr><tr><td>6 HTTP 403<\/td><td>Insufficient funds<\/td><td>Low balance, unable to process the request<\/td><\/tr><tr><td>10 HTTP 400<\/td><td>Invalid request<\/td><td>Malformed request<\/td><\/tr><tr><td>11 HTTP 400<\/td><td>Invalid number<\/td><td>Invalid number format. The number must be in E.164 format<\/td><\/tr><tr><td>16 HTTP 400<\/td><td>Sender not allowed<\/td><td>Sender ID is not allowed for this type of request<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 id=\"obtaining-statuses\" class=\"anchor\">Retrieving statuses<\/h2>\n\n\n\n<p style=\"font-size:15px\">Status retrieval must be configured via Callback.<\/p>\n\n\n\n<h2 id=\"callback-paprametrs\" class=\"anchor\">Callback parameters<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Parameter<\/strong><\/th><th><strong>Description<\/strong><\/th><\/tr><\/thead><tbody><tr><td>requestId<\/td><td>Unique request identifier on the partner\u2019s side<\/td><\/tr><tr><td>number<\/td><td>Subscriber\u2019s phone number<\/td><\/tr><tr><td>status<\/td><td>Status (see table below)<\/td><\/tr><tr><td>timestamp<\/td><td>Status change time in unixtime format<\/td><\/tr><tr><td>appKey<\/td><td>Application API key<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 id=\"status-comparison\" class=\"anchor\">Status mapping<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Partner Status<\/strong><\/th><th><strong>Description<\/strong><\/th><th><strong>Corresponding <code>Message_state<\/code><\/strong><\/th><\/tr><\/thead><tbody><tr><td>ANSWERED<\/td><td>Call connected, subscriber answered<\/td><td>DELIVERED<\/td><\/tr><tr><td>TERMINATED<\/td><td>Call reached subscriber, but not answered (call ended due to TTL expiration or command)<\/td><td><\/td><\/tr><tr><td>BUSY_HERE<\/td><td>Call reached subscriber, but subscriber rejected the call<\/td><td><\/td><\/tr><tr><td>REJECTED<\/td><td>Call cannot be completed, e.g., number is busy with another call or other SIP error<\/td><td>UNDELIVERED<\/td><\/tr><tr><td>UNAVAILABLE<\/td><td>Subscriber unavailable, phone is off<\/td><td><\/td><\/tr><tr><td>FORBIDDEN<\/td><td>Returned when anti-fraud protection is triggered<\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Flash Call is a modern authentication technology that uses an incoming call to verify the user\u2019s identity. Unlike standard SMS codes, Flash Call allows for a faster and more convenient verification process. FlashCall requests Request: Parameters are passed in the request body: Example requests using CURL: Parameter Description number Phone number in e.164 formatThe field <a href=\"https:\/\/docs.unibell.tech\/?page_id=3515\" class=\"more-link\">&#8230;<span class=\"screen-reader-text\">  Flash\u0421all API<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"tpl\/http-content.php","meta":{"footnotes":""},"class_list":["post-3515","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3515","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3515"}],"version-history":[{"count":4,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3515\/revisions"}],"predecessor-version":[{"id":3581,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3515\/revisions\/3581"}],"wp:attachment":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3515"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}