click fraud detection

API создание звонков



Звонки, метод: /api/registercall/

Параметры

Пример:

http://myboxurl/api/registercall/?login=LOGIN&password=PASSWORD&channel=123453545453&status=INCOMING&caller=380931122334&cellee=302

Поле Тип Описание Обязательное или нет Коментарий
1 login string Логин в системе BOX Обязательное поле.  
2 password string Пароль в формате md5 Обязательное поле. Напишите в техподдержку и мы выдадим вам hash для API
3 channel string Канал звонка (идентификатор звонка) Обязательное поле.  
4 status string Статус звонка Обязательное поле. Звонок может создатся со статусами: LOCAL, INCOMING, OUTGOING, TRANSFER. Если вы передадите статусы завершающего звонка (CANCEL, ANSWER, CONGESTION, CHANUNAVAIL, BUSY, INVALID, TRANSFER), то звонок закроется.
Подробно о каждом статусе:
LOCAL - Локальный звонок (внутрений)
INCOMING - Входящий звонок
OUTGOING - Исходящий звонок
TRANSFER - Звонок переведён
CANCEL - caller положил трубку
ANSWER - Есть ответ на звонок (есть разговор)
CONGESTION - линия перегружена
CHANUNAVAIL - линия недоступна
BUSY - линия занята
NOANSWER - callee не ответил на звонок
INVALID - некорректный номер/перевод
5 caller integer Кто звонит (номер телефона) Обязательное поле.  
6 callee integer Кому звонит (номер телефона) Не обязательное поле. Если не указывать тут ничего то система при входящем звонке будет подставлять сюда номера по умолчанию
7 pickup integer кто поднял трубку при групповом звонке Не обязательное поле.  
8 duration integer длительность вызова Не обязательное поле. Передавайте сюда длительность звонка при зарешающих статусах (CANCEL, ANSWER, CONGESTION, CHANUNAVAIL, BUSY, INVALID, TRANSFER)
8 filename string Путь и имя аудио файла при звонках Не обязательное поле. Передавайте сюда имя аудиофайла звонка при зарешающих статусах (CANCEL, ANSWER, CONGESTION, CHANUNAVAIL, BUSY, INVALID, TRANSFER)
9 comment text Комментарий к звонку Не обязательное поле. Комментарий к звонку будет записан как описание события
10 closed bool Закрыть звонок и всплывающее окно Не обязательное поле. Не обязательное поле.Если будет передан аргумент closed=1 то окно закроется, если closed=0 то нет (это все при статусах звонка ANSWER или CANCEL или CONGESTION или CHANUNAVAIL или BUSY или INVALID) . Так же рекомендуется передавать closed=0 в момент когда начался разговор

Возможные варианты ответа на запрос

Подробнее
Статус Сообщение Описание сообщения
1 ok   Регистрация звонка прошла успешно
2 fail Login is empty! Отсутствует логин
3 fail Password is empty! Отсутствует пароль
4 fail Login or password not correct! Неправильный логин или пароль
5 fail Bad user level! Низкий уровень пользователя, для выполнения данного действия(нужен level 2 и выше)
6 fail No channel Отсутствует канал звонка
7 fail No status Отсутствует статус звонка
8 fail No caller Отсутствует номер звонившего

Также могут возникать ошибки:

502 Bad Gateway - Если возникла данная ошибка необходимо:
1. Проверить, имеется ли доступ к Интернету (зайти на любой другой сайт).
2. Если проблем с доступом нет — можно удалить файлы cookies.
Если указанное выше не помогло — проблема на стороне сервера. Следует обратиться к системному администратору сайта.

503 (Service Temporarily Unavailable) - данная ошибка может возникать в результате слишком большого количества запросов к серверу. Если вы увидели такую ошибку, стоит подождать пару минут и попробовать снова.

504 Gateway Timeout - cкорее всего дело в возросшей нагрузке на сайт, при которой Apache не успевает отдавать HTTP-ответы, и новые запросы встают в очередь. Чтобы решить проблему, можно добавить ресурсов серверу, в частности оперативной памяти, и увеличить количество процессов httpd (Apache).
Другая возможная причина возникновения ошибки 504 - исполняемый скрипт не укладывается в отведенный лимит времени. Это бывает, когда запрос слишком тяжелый. Попробуйте разбить свой запрос на несколько более маленьких.

Ошибка 505 HTTP Version not supported означает, что веб-сайт не поддерживает версию протокола HTTP, с помощью которого браузер осуществляет запрос веб-страницы