> For the complete documentation index, see [llms.txt](https://docs.telefon-ip.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telefon-ip.ru/reference/api-reference/back-calls-obratnaya-avtorizaciya-zvonkom.md).

# Back Calls - обратная авторизация звонком

Запросы выполняются методом **GET** на URL: 

**<https://api.telefon-ip.ru/api/v1/authcalls/{token}/{action}/{params}>**  где:&#x20;

**token  -** ключ доступа к API, который можете получить в личном кабинете или по запросу на <support@telefon-ip.ru>. Первые 50 запросов для тестирования бесплатно.&#x20;

**action** - вызываемые функции API описанные ниже в документации

**params** - передаваемые параметры в зависимости от метода вызова, обычно для GET запроса

## reverse\_auth\_phone\_get - получение номера для авторизации

<mark style="color:blue;">`GET`</mark> `https://api.telefon-ip.ru/api/v1/authcalls/<token>/reverse_auth_phone_get`

При запросе вы получаете случайный номер для звонка, а также id для получения информации о совершении звонка абонентом на этот номер. Для получения информации используйте функцию check\_phone. Время жизни номера для авторизации составляет 120 секунд.

**Example**

<https://api.telefon-ip.ru/api/v1/authcalls/4ea13fbf-f5a3-4084-8b01-9733cd6fd0b1/reverse\\_auth\\_phone\\_get?phone=89000000000>

#### Path Parameters

| Name                                    | Type   | Description  |
| --------------------------------------- | ------ | ------------ |
| token<mark style="color:red;">\*</mark> | String | Ключ доступа |

#### Query Parameters

| Name                                    | Type   | Description                                       |
| --------------------------------------- | ------ | ------------------------------------------------- |
| phone<mark style="color:red;">\*</mark> | String | Номер телефона пользователя в формате 89ххххххххх |

{% tabs %}
{% tab title="200: OK Номер телефона для авторизации" %}

```javascript
{
    "success": true,
    "error": "",
    "data": {
        "auth_phone": "79644115786",
        "id": 122760,
        "url_image": "https://api.telefon-ip.ru/api/v1/authcalls/get_qr_image/2841621/"
        "url_link": "<a href='tel:89644078713'>Позвони для авторизации</a>"
}
}
```

{% endtab %}

{% tab title="401: Unauthorized Ошибка авторизации" %}

```javascript
{
    "success": false,
    "error": "Unauthorized token",
    "data": {}
}
```

{% endtab %}

{% tab title="400: Bad Request Неправильный формат номера телефона пользователя" %}

```
{
    "success": false,
    "error": "does not match the format 89XXXXXXXXX or phone field is missing",
    "data": phone
}
```

{% endtab %}
{% endtabs %}

## reverse\_auth\_phone\_post - получение номера для авторизации

<mark style="color:green;">`POST`</mark> `https://api.telefon-ip.ru/api/v1/authcalls/<token>/reverse_auth_phone_post`

При запросе вы получаете случайный номер для звонка, а также id для получения информации о совершении звонка абонентом на этот номер. При подтверждении авторизации отправляется webhook на указанный url. Время жизни номера для авторизации составляет 120 секунд.

Формат возвращаемого webhook:

url\_адрес[?success=True\&phone=89000000000\&id=0](<	https://webhook.site/b6dd4f71-7035-4af3-b8e1-1ff9874c3929?success=True\&phone=89243555100\&id=2841621>)00000

#### Path Parameters

| Name  | Type   | Description  |
| ----- | ------ | ------------ |
| token | String | Ключ доступа |

#### Request Body

| Name                                      | Type   | Description                                       |
| ----------------------------------------- | ------ | ------------------------------------------------- |
| phone<mark style="color:red;">\*</mark>   | String | Номер телефона пользователя в формате 89ххххххххх |
| webhook<mark style="color:red;">\*</mark> | String | URL для получения ответа                          |

{% tabs %}
{% tab title="200: OK Номер телефона для авторизации" %}

```
{
    "success": true,
    "error": "",
    "data": {
        "auth_phone": "79644115786",
        "id": 122760,
        "url_image": "https://api.telefon-ip.ru/api/v1/authcalls/get_qr_image/2841621/"
        "url_link": "<a href='tel:89644078713'>Позвони для авторизации</a>"
}
}
```

{% endtab %}
{% endtabs %}

## reverse\_auth\_phone\_check - получение номера телефона клиента по id авторизации

<mark style="color:blue;">`GET`</mark> `https://api.telefon-ip.ru/api/v1/authcalls/<token>/reverse_auth_phone_check/<id>`

**Example**

<https://api.telefon-ip.ru/api/v1/authcalls/4ea13fbf-f5a3-4084-8b01-9733cd6fd0b1/reverse\\_auth\\_phone\\_check/122760>

#### Path Parameters

| Name                                    | Type    | Description                                           |
| --------------------------------------- | ------- | ----------------------------------------------------- |
| token<mark style="color:red;">\*</mark> | String  | Ключ доступа                                          |
| id<mark style="color:red;">\*</mark>    | Integer | id авторизации полученный от функции get\_auth\_phone |

{% tabs %}
{% tab title="200: OK Номер телефона клиента" %}

```javascript
{
    "success": true,
    "error": "",
    "data": {
        "phone": "89243555100",
        "id": 122760
    }
}
```

{% endtab %}

{% tab title="401: Unauthorized Ошибка авторизации" %}

```javascript
{
    "success": false,
    "error": "Unauthorized token",
    "data": {}
}
```

{% endtab %}

{% tab title="204: No Content Нет информации о номере абонента" %}

```
{
    "success": true,
    "error": "",
    "data": {
        "phone": "",
        "id": 122760
    }
}
```

{% endtab %}

{% tab title="408: Request Timeout Истекло время ожидания" %}

```
{
    "success": fales,
    "error": "time expired",
    "data": {
        "phone": "",
        "id": 122760
    }
}
```

{% endtab %}
{% endtabs %}