1b.app
Скопійоване посилання -

API створення дзвінків

Дзвінки, метод: /api/registercall/

Параметри

Приклад:

http://myboxurl/api/registercall/?login=LOGIN&password=PASSWORD&channel=123453545453&status=INCOMING&caller=380931122334&callee=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, за допомогою якого браузер здійснює запит веб-сторінки