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 в сообщении, стоимость сообщения
clientIdId сообщения на стороне клиента (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Пароль
smscIdId сообщения на стороне сервера
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