API личного кабинета

Этот вид интеграции работает посредством простого вызова скрипта с нашего сервера.

Например, в PHP, это можно сделать так:

file_get_contents("ссылка");

Ответ от сервера приходит в виде json-строки

Возможности:

Отправка СМС
Адрес: http:// cabinet.rus-sms.ru/lcabApi/sendSms.php?login=логин&password=пароль&to= 7хххххххххх&txt=текст+смс

Текст смс должен быть в кодировке utf-8, и обработан функцией urlencode.

 

К примеру, если у вас скрипты в кодировке windows-1251:

$text = "Привет!";

$text = iconv("cp1251","utf-8",$text);

$text = urlencode($text);

Можно также отправить смс вашей группе абонентов из телефонной книги, передав вместо (или вместе c) to параметр &idGroup=x, где x - id нужной группы.

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата

priceOfSending - стоимость рассылки (если code = 1)

colsmsOfSending - количество смс в рассылке (если code = 1)


Добавление контакта в телефонную книгу

Адрес: http://cabinet.rus-sms.ru/lcabApi/addContact.php?login=логин&password=пароль&idGroup=id_группы&phone=7xxxxxxxxxx &f=фамилия&i=имя&o=отчество

Обязательными являются только login, password, idGroup и phone. ID группы можно узнать в телефонной книге, наведя курсор на нужную группу.

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата


Удаление контакта из телефонной книги

Адрес: http://cabinet.rus-sms.ru/lcabApi/removeContact.php?login=логин&password=пароль&phone=7xxxxxxxxxx

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата


Проверка на существование контакта в телефонной книге

Адрес: http://cabinet.rus-sms.ru/lcabApi/contactExists.php?login=логин&password=пароль&phone=7xxxxxxxxxx

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата

contactExists - 1, если контакт найден, 0 - если нет.


Получение списка групп из телефонной книги

Адрес: http://cabinet.rus-sms.ru/lcabApi/getGroups.php?login=логин&password=пароль

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата

groups - массив с группами


Получение контактов из телефонной книги

Адрес: http://cabinet.rus-sms.ru/lcabApi/getContacts.php?login=логин&password=пароль&idGroup=id_группы

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата

contacts - массив с контактами


Получение количества контактов в группе

Адрес: http://cabinet.rus-sms.ru/lcabApi/getCount.php?login=логин&password=пароль&idGroup=id_нужной_группы

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата

count - количество контактов в группе (если code = 1)


Получение данных о вашей организации

Адрес: http://cabinet.rus-sms.ru/lcabApi/info.php?login=логин&password=пароль

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата

tarif - название тарифа price - цена за СМС

account - остаток на счету

ocode - номер лицевого счета

source - массив с доступными именами отправителя


Запрос нового имени отправителя

Адрес: http://cabinet.rus-sms.ru/lcabApi/requestSource.php?login=логин&password=пароль&source=имя_отправителя

Возвращает:

code - код результата выполнения операции (1 - успешно, все остальное - ошибки)

descr - описание кода результата