Документация API по услуге "Отправка кодов в голосовом сообщении при звонке": различия между версиями

Материал из Wiki NeoCommunications
Перейти к навигации Перейти к поиску
(01)
Строка 6: Строка 6:
 
'''Обязательные параметры:'''
 
'''Обязательные параметры:'''
 
<br />
 
<br />
''apiKey'' - Ваш ключ из личного кабинета
+
*''apiKey'' - Ваш ключ из личного кабинета
<br />
+
*''phone'' - Номер телефона куда звонить (11 цифр в международном формате без знака «+». Допустимы только российские номера, т.е. номер должен начинаться с цифры «7»).
''phone'' - Номер телефона куда звонить (11 цифр в международном формате без знака «+». Допустимы только российские номера, т.е. номер должен начинаться с цифры «7»).
 
  
<br />
 
 
'''Необязательный параметр:'''
 
'''Необязательный параметр:'''
 
<br />
 
<br />
code - код (3 или 4 цифры) для воспроизведения его синтезированным голосом. Параметр "code" необязателен.
+
*code - код (3 или 4 цифры) для воспроизведения его синтезированным голосом. Если его нет в запросе, код будет сгенерирован из 3-х случайных цифр.
<br />
 
Если его нет в запросе, код будет сгенерирован из 3-х случайных цифр.
 
  
 
Ответ возвращается всегда в виде JSON-массива, первый элемент которого называется status и может принимать значения:
 
Ответ возвращается всегда в виде JSON-массива, первый элемент которого называется status и может принимать значения:
  
ok - звонок отправлен
+
*ok - звонок отправлен
<br />
+
*error - произошла ошибка
error - произошла ошибка
+
 
 +
В случае успеха (status=ok) , второй элемент массива, который называется "code", содержит код, который будет озвучен клиенту. Затем предпримается попытка звонка на указанный в запросе номер и синтезированным голосом произнесен код.
  
 
В случае, если произошла ошибка (status=error), то второй элемент, который называется reason содержит краткое название ошибки.
 
В случае, если произошла ошибка (status=error), то второй элемент, который называется reason содержит краткое название ошибки.
Строка 27: Строка 24:
 
Возможные ошибки:
 
Возможные ошибки:
  
invalidParams - не переданы обязательные параметры (apiKey, phone)
+
*invalidParams - не переданы обязательные параметры (apiKey, phone)
<br />
+
*invalidApiKey – неверный apiKey
invalidApiKey – неверный apiKey
+
*invalidPhone - телефон не состоит из 11 цифр или не является российским
<br />
+
*lowBalance – у вас нулевой баланс, докупите звонков в личном кабинете
invalidPhone - телефон не состоит из 11 цифр или не является российским
 
<br />
 
lowBalance – у вас нулевой баланс, докупите звонков в личном кабинете
 
 
 
В случае успеха (status=ok) , второй элемент массива, который называется "code", содержит код, который будет озвучен клиенту. Затем предпримается попытка звонка на указанный в запросе номер и синтезированным голосом произнесен код.
 
  
 
Если клиент не ответил на звонок, или сбросил вызов не подняв трубку, дозвон будет продолжаться.
 
Если клиент не ответил на звонок, или сбросил вызов не подняв трубку, дозвон будет продолжаться.

Версия 16:41, 20 сентября 2017

Для звонка необходимо обратится методом HTTP-GET к скрипту https://neocomms.ru/codesay_api/call.php
Пример запроса: https://neocomms.ru/codesay_api/call.php?apiKey=354b84059216d758c591a9fc3882a570&phone=79031...

Обязательные параметры:

  • apiKey - Ваш ключ из личного кабинета
  • phone - Номер телефона куда звонить (11 цифр в международном формате без знака «+». Допустимы только российские номера, т.е. номер должен начинаться с цифры «7»).

Необязательный параметр:

  • code - код (3 или 4 цифры) для воспроизведения его синтезированным голосом. Если его нет в запросе, код будет сгенерирован из 3-х случайных цифр.

Ответ возвращается всегда в виде JSON-массива, первый элемент которого называется status и может принимать значения:

  • ok - звонок отправлен
  • error - произошла ошибка

В случае успеха (status=ok) , второй элемент массива, который называется "code", содержит код, который будет озвучен клиенту. Затем предпримается попытка звонка на указанный в запросе номер и синтезированным голосом произнесен код.

В случае, если произошла ошибка (status=error), то второй элемент, который называется reason содержит краткое название ошибки.
Возможные ошибки:

  • invalidParams - не переданы обязательные параметры (apiKey, phone)
  • invalidApiKey – неверный apiKey
  • invalidPhone - телефон не состоит из 11 цифр или не является российским
  • lowBalance – у вас нулевой баланс, докупите звонков в личном кабинете

Если клиент не ответил на звонок, или сбросил вызов не подняв трубку, дозвон будет продолжаться.
Всего будет совершено до 3-х попыток звонка. Длительность ожидания поднятия трубки - 30 секунд.

Безопасность

Для того чтобы apiKey не украли и не вызвонили все деньги на вашем балансе, рекомендуем обращаться к API не с помощью AJAX, а с сервера, например с помощью cURL:

     <?php
          $curl = curl_init ();
          curl_setopt ($curl, CURLOPT_URL, "https://neocomms.ru/codesay_api/call.php?
          apiKey=354b84059216d758c591a9fc3882a570&phone=79031234567&code=4375");
          curl_setopt ($curl, CURLOPT_RETURNTRANSFER, 1);
          curl_setopt ($curl, CURLOPT_TIMEOUT, 30);
          curl_setopt ($curl, CURLOPT_CUSTOMREQUEST, "GET");
          echo curl_exec ($curl);
     ?>