Register and get 10 free SMS.
Login
ЛогинПарольЗабыли пароль?
Бесплатно по РФ: 8 800 333-777-9
support@smsbliss.ru

JSON интерфейс

Передача сообщения (до 200 сообщений в запросе)
Проверка состояния отправленных сообщений (до 200 сообщений в запросе)
Проверка очереди статусов сообщений (до 1000 сообщений в запросе)
Проверка состояния счета
Список доступных подписей отправителя
Проверка активной версии API
 

Передача сообщения (до 200 сообщений в запросе)

POST запрос http://api.smsbliss.net/messages/v2/send.json
  1. {
  2. "scheduleTime":"2008-07-12T14:30:01Z",
  3. "messages":[
  4. {
  5. "phone":"71234567890",
  6. "sender":"MySender",
  7. "clientId":"1",
  8. "text":"Message text here"
  9. },
  10. {
  11. "phone":"71234567891",
  12. "clientId":"2",
  13. "text":"text"
  14. },
  15. {
  16. "phone":"71234567892",
  17. "sender":"MySender",
  18. "clientId":"3",
  19. "text":"Message text here"
  20. }
  21. ],
  22. "statusQueueName":"myQueue",
  23. "showBillingDetails":true,
  24. "login":"login",
  25. "password":"password"
  26. }
ПараметрОписание
login✔Логин
password✔Пароль
scheduleTimeДата для отложенной отправки сообщения, в UTC (2008-07-12T14:30:01Z)
statusQueueNameНазвание очереди статусов отправленных сообщений, в случае, если вы хотите использовать очередь статусов отправленных сообщений. От 3 до 16 символов, буквы и цифры (например myQueue1)
showBillingDetailsВключение в ответ биллинговых данных: баланса, количества SMS в сообщении, стоимость сообщения
clientId✔Id сообщения на стороне клиента (A-Z 0-9, макс. 72 симв.)
phone✔Номер телефона, в формате +71234567890
text✔Текст сообщения, в UTF-8 кодировке
senderПодпись отправителя (например TEST)
При успешной авторизации сервер должен вернуть json ответ вида
  1. {
  2. "status":"ok",
  3. "balance":[],
  4. "messages":[
  5. {
  6. "status":"accepted",
  7. "smscId":"12345",
  8. "clientId":"1"
  9. },
  10. {
  11. "status":"sender address invalid",
  12. "smscId":"12346",
  13. "clientId":"2"
  14. }
  15. ]
  16. }
где сервис выдает результаты обработки сообщений
Параметр/значениеОписание
statusСтатус приема пакета (ok – ошибок не обнаружено)
clientIdId сообщения на стороне клиента
smscIdId сообщения на стороне сервера (A-F 0-9, макс. 72 симв.)
status (в messages)Статус отправки сообщения (подробнее о статусах в описании REST интерфейса)
smsCountКоличество SMS в сообщении
msgCostСтоимость сообщения (тариф умноженный на количество SMS). Отображается, если клиент использует рублевый баланс
balanceОстатки средств на балансе, после отправки сообщений
 

Проверка состояния отправленных сообщений (до 200 сообщений в запросе)

POST запрос http://api.smsbliss.net/messages/v2/status.json
  1. {
  2. "login":"login",
  3. "password":"password",
  4. "messages":[
  5. {
  6. "smscId":"12345",
  7. "clientId":"1"
  8. },
  9. {
  10. "smscId":"12346"
  11. }
  12. ]
  13. }
ПараметрОписание
login✔Логин
password✔Пароль
smscId✔Id сообщения на стороне сервера
clientIdId сообщения на стороне клиента
При успешной авторизации сервер должен вернуть json ответ вида
  1. {
  2. "status":"ok/error",
  3. "messages":[
  4. {
  5. "status":"delivered",
  6. "smscId":"12345",
  7. "clientId":"1"
  8. },
  9. {
  10. "status":"smsc reject",
  11. "smscId":"12346"
  12. }
  13. ]
  14. }
где сервис выдает статусы сообщений
Параметр/значениеОписание
statusСтатус приема пакета (ok – ошибок не обнаружено)
smscIdId сообщения на стороне сервера
clientIdId сообщения на стороне клиента (если было указано)
status (в messages)Статус отправленного сообщения (подробнее о статусах в описании REST интерфейса)
 

Проверка очереди статусов сообщений (до 1000 сообщений в запросе)

POST запрос http://api.smsbliss.net/messages/v2/statusQueue.json
  1. {
  2. "login":"login",
  3. "password":"password",
  4. "statusQueueLimit":"100",
  5. "statusQueueName":"myQueue"
  6. }
ПараметрОписание
login✔Логин
password✔Пароль
statusQueueName✔Название очереди статусов сообщений. Название очереди устанавливается при передаче сообщения
statusQueueLimit✔Количество запрашиваемых статусов из очереди (по умолчанию 1, макс. 1000)
При успешной авторизации сервер должен вернуть json ответ вида
  1. {
  2. "status":"ok/error",
  3. "messages":[
  4. {
  5. "status":"delivered",
  6. "smscId":"12345"
  7. },
  8. {
  9. "status":"smsc reject",
  10. "smscId":"12346"
  11. }
  12. ]
  13. }
где сервис выдает статусы сообщений
Параметр/значениеОписание
statusСтатус приема пакета (ok – ошибок не обнаружено)
smscIdId сообщения на стороне сервера
status (в messages)Статус отправленного сообщения (подробнее о статусах в описании REST интерфейса)
 

Проверка состояния счета

POST запрос http://api.smsbliss.net/messages/v2/balance.json
  1. {
  2. "login":"login",
  3. "password":"password"
  4. }
ПараметрОписание
login✔Логин
password✔Пароль
При успешной авторизации сервер должен вернуть json ответ вида
  1. {
  2. "status":"ok/error",
  3. "balance":[
  4. {
  5. "credit":0.0,
  6. "balance":"0.00",
  7. "type":"RUB"
  8. },
  9. {
  10. "credit":1000000,
  11. "balance":-508784,
  12. "type":"SMS"
  13. }
  14. ]
  15. }
где сервис выдает информацию о балансах клиента: типе баланса, количестве и возможном кредите (возможности использовать сервис при отрицательном балансе)
Параметр/значениеОписание
statusСтатус приема пакета (ok – ошибок не обнаружено)
typeТип баланса: RUB, SMS
balanceКоличество средств на балансе
creditКредит (возможность использовать сервис при отрицательном балансе)
 

Список доступных подписей отправителя

POST запрос http://api.smsbliss.net/messages/v2/senders.json
  1. {
  2. "login":"login",
  3. "password":"password"
  4. }
ПараметрОписание
login✔Логин
password✔Пароль
При успешной авторизации сервер должен вернуть json ответ вида
  1. {
  2. "status":"ok/error",
  3. "senders":[
  4. {
  5. "status":"active",
  6. "info":"",
  7. "name":"MyBrand"
  8. },
  9. {
  10. "status":"pending",
  11. "info":"",
  12. "name":"3132018"
  13. },
  14. {
  15. "status":"blocked",
  16. "info":"bad name",
  17. "name":"MegaFon"
  18. },
  19. {
  20. "status":"default",
  21. "info":"",
  22. "name":"TEST"
  23. }
  24. ]
  25. }
где сервис выдает информацию о подписях отправителя
Параметр/значениеОписание
statusСтатус приема пакета (ok – ошибок не обнаружено)
sendersСписок доступных подписей
activeПодпись активирована и готова к использованию
newНовая подпись
pendingПодпись в процессе активации
blockedПодпись заблокирована
defaultПодпись по умолчанию, готова к использованию
 

Проверка активной версии API

POST запрос http://api.smsbliss.net/messages/v2/version.json/
  1. {
  2. "login":"login",
  3. "password":"password"
  4. }
ПараметрОписание
login✔Логин (на выбор: GET параметр или basic access authentication)
password✔Пароль (на выбор: GET параметр или basic access authentication)
При успешной авторизации сервер должен вернуть json ответ вида
  1. {
  2. "status":"ok/error",
  3. "version":2
  4. }
Параметр/значениеОписание
statusСтатус приема пакета (ok – ошибок не обнаружено)
versionНомер активной версии API