Інтеграція з сервісом (API)

Відправка SMS-повідомлення

Все параметры, которые содержат специальные символы (плюс, пробел и т.д.), должны быть закодированы при помощи функции urlencode для передачи в HTTP-запросе.

Відповідь сервера і коди помилок

• ERROR = N (опис) – для помилок 1, 2, 4, 5, 9;
  
  
• ERROR = N (описание), ID - <id сообщения> – для помилок 3, 6, 7, 8.

• 0,-N – для помилок 1, 2, 4, 5, 9;
• <id сообщения>,-N – для помилок 3, 6, 7, 8.

• Для помилок 1, 2, 4, 5, 9:
  
  

  <result> <error>описание</error> <error_code>N</error_code> </result>

  
  
• Для помилок 3, 6, 7, 8:

  <result> <error>описание</error> <error_code>N</error_code> <id>id сообщения</id> </result>

• Для помилок 1, 2, 4, 5, 9:

  { "error": "опис", "error_code": N }

  
  
• Для помилок 3, 6, 7, 8:

  { "error": "опис", "error_code": N, "id": <id сообщения> }

• при cost = 0 и fmt = 0: OK - <n> SMS, ID - <id>
  
  
• при cost = 1 и fmt = 0: <cost> (<n> SMS)
  
  
• при cost = 2 и fmt = 0: OK - <n> SMS, ID - <id>, COST - <cost>
  
  
• при cost = 3 и fmt = 0: OK - <n> SMS, ID - <id>, COST - <cost>, BALANCE - <balance>
  
  
• при cost = 0 и fmt = 1: <id>,<n>
  
  
• при cost = 1 и fmt = 1: <cost>,<n>
  
  
• при cost = 2 и fmt = 1: <id>,<n>,<cost>
  
  
• при cost = 3 и fmt = 1: <id>,<n>,<cost>,<balance>
  
  
• при cost = 0 и fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> </result>

  
  
• при cost = 1 и fmt = 2:

  <result> <cost>cost</cost> <cnt>n</cnt> </result>

  
  
• при cost = 2 и fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> <cost>cost</cost> </result>

  
  
• при cost = 3 и fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> <cost>cost</cost> <balance>balance</balance> </result>

  
  
• при cost = 0 и fmt = 3:

  { "id": <id>, "cnt": <n> }

  
  
• при cost = 1 и fmt = 3:

  { "cost": "<cost>", "cnt": <n> }

  
  
• при cost = 2 и fmt = 3:

  { "id": <id>, "cnt": <n>, "cost": "<cost>" }

  
  
• при cost = 3 и fmt = 3:

  { "id": <id>, "cnt": <n>, "cost": "<cost>", "balance": "<balance>" }

  
  
• при op = 1 і fmt = 0 або 1, інформація додається в кінець звичайного виведення з нового рядка:
  <phone>,<mccmnc>,<cost>,<status>,<error>
  
  
• при op = 1 і fmt = 2, у відповідь додається масив:

  <phones> <phone mccmnc="mccmnc" cost="cost" status="status" error="error">phone</phone> ... </phones>

  
  
• при op = 1 і fmt = 3, у відповідь додається масив:

  "phones": [{ "phone": "<phone>", "mccmnc": "<mccmnc>", "cost": "<cost>", "status": "<status>", "error": "<error>" }, ... ]

  
  

Сервер не приймає більше одного однакового запиту на відправку SMS-повідомлень протягом хвилини для захисту від помилок і зациклення в програмі на стороні Клієнта для того, щоб знизити навантаження і не витрачати кошти Клієнта, а також не допустити багаторазової відправки повідомлення одного абонента.

Сервер також блокує відправлення більш 50 повідомлень одному абоненту, які були відправлені з перервою між повідомленнями менш 60-ти секунд, для захисту від флуду і зайвого списання коштів з рахунку Клієнта, так як багато операторів не пропускають велику кількість повідомлень одному абоненту за короткий проміжок часу.

Приклади відправки повідомлень