# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.telefon-ip.ru/reference/api-reference/back-calls-obratnaya-avtorizaciya-zvonkom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.