Îòïðàâêà 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-òè ñåêóíä, äëÿ çàùèòû îò ôëóäà è ëèøíåãî ñïèñàíèÿ ñðåäñòâ ñî ñ÷åòà Êëèåíòà, òàê êàê ìíîãèå îïåðàòîðû íå ïðîïóñêàþò áîëüøîå êîëè÷åñòâî ñîîáùåíèé îäíîìó àáîíåíòó çà êîðîòêèé ïðîìåæóòîê âðåìåíè.

Ïðèìåðû îòïðàâêè ñîîáùåíèé