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

Авторизация происходит за счет звонка абонентом на случайный выделенный номер, при звонке происходит сброс вызова. Номер пользователя возвращается по webhook или через get запрос.

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

https://api.telefon-ip.ru/api/v1/authcalls/{token}/{action}/{params} где:

token - ключ доступа к API, который можете получить в личном кабинете или по запросу на [e-mail]. Первые 50 запросов для тестирования бесплатно.

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

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

reverse_auth_phone_get - получение номера для авторизации

GET 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*	String	Ключ доступа

Query Parameters

Name	Type	Description
phone*	String	Номер телефона пользователя в формате 89ххххххххх

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:[phone]'>Позвони для авторизации</a>"
}
}

401: Unauthorized Ошибка авторизации

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

400: Bad Request Неправильный формат номера телефона пользователя

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

reverse_auth_phone_post - получение номера для авторизации

POST https://api.telefon-ip.ru/api/v1/authcalls/<token>/reverse_auth_phone_post

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

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

url_адрес?success=True&phone=89000000000&id=000000

Path Parameters

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

Request Body

Name	Type	Description
phone*	String	Номер телефона пользователя в формате 89ххххххххх
webhook*	String	URL для получения ответа

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:[phone]'>Позвони для авторизации</a>"
}
}

reverse_auth_phone_check - получение номера телефона клиента по id авторизации

GET 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*	String	Ключ доступа
id*	Integer	id авторизации полученный от функции get_auth_phone

200: OK Номер телефона клиента

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

401: Unauthorized Ошибка авторизации

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

204: No Content Нет информации о номере абонента

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

408: Request Timeout Истекло время ожидания

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