Difference between revisions of "MO SOAP"

From SMS Wiki
Jump to: navigation, search
(New page: Collecting mobile originated messages from your account using SOAP methods is done using 4 available functions: * GetNewInboxCount - returns the number of new messages in your Inbox * Ge...)
 
Line 9: Line 9:
 
* GetBottomMessage - Used to get the earliest new sms message in inbox. Message flag is set to "read" after this function is completed  
 
* GetBottomMessage - Used to get the earliest new sms message in inbox. Message flag is set to "read" after this function is completed  
  
 +
Before you can use these functions you must obtain Token/Signature for your account. This is needed only once.
  
−
Send_Plain_Multiple is API function that allows you to send up to 25 messages (same message to 25 recipients) with one function call. This page describes error statuses which Send_Plain_Multiple can generate
 
  
 +
'''''Results'''''
 +
 +
'''Result of method GetNewInboxCount'''
  
−
'''Send successful - all messages were sent'''
 
 
----
 
----
−
  <?xml version="1.0" encoding="utf-8" ?>
 
−
- <SMSSendMultipleResult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms">
 
−
  <isOk>true</isOk>
 
−
  <successCount>3</successCount>
 
−
  <failedCount>0</failedCount>
 
−
  </SMSSendMultipleResult>
 
  
 +
<?xml version="1.0" encoding="utf-8" ?>
 +
<int xmlns="http://upsidewireless.com/webservice/sms">2</int>
  
−
'''''Failed sending or partial fail'''''
 
  
−
'''No recipients - no message will be sent'''
+
'''Result of method GetNewInboxMessages'''  
 
----
 
----
 
   <?xml version="1.0" encoding="utf-8" ?>  
 
   <?xml version="1.0" encoding="utf-8" ?>  
−
- <SMSSendMultipleResult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms">
+
- <ArrayOfNewSMSMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms">
−
   <isOk>false</isOk>  
+
- <NewSMSMessage>
−
   <successCount>0</successCount>  
+
   <isValid>true</isValid>  
−
   <failedCount>0</failedCount>  
+
   <sender>+17788580767</sender>  
−
   <errorMessages>No recipients</errorMessages>  
+
   <data>e test email command</data>  
−
   </SMSSendMultipleResult>
+
   <name>username</name>
 +
  <inboundnumber>16047658410</inboundnumber>
 +
  <messageid>Mail1280535182021-4</messageid>
 +
  </NewSMSMessage>
 +
- <NewSMSMessage>
 +
  <isValid>true</isValid>
 +
  <sender>+17788580767</sender>
 +
  <data>test message</data>
 +
  <name>username</name>
 +
  <inboundnumber>16047658410</inboundnumber>
 +
  <carriercode>302720</carriercode>
 +
  <messageid>Mail1300928784355-5</messageid>
 +
  </NewSMSMessage>
 +
   </ArrayOfNewSMSMessage>
  
  
−
'''Excess maximum recipients - no message will be sent'''
+
'''Result of method GetTopMessage'''
 
----
 
----
 
   <?xml version="1.0" encoding="utf-8" ?>  
 
   <?xml version="1.0" encoding="utf-8" ?>  
−
- <SMSSendMultipleResult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms">
+
- <NewSMSMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms">
−
   <isOk>false</isOk>  
+
   <isValid>true</isValid>  
−
   <successCount>0</successCount>  
+
   <sender>+17788580767</sender>  
−
   <failedCount>26</failedCount>  
+
   <data>test message</data>  
−
   <errorMessages>Excess maximum recipients (25)</errorMessages>  
+
   <name>taylorsun</name>  
−
   <errorNumbers>17788580767,16046668888,17788456789, 456789, 123456, 65743211, ...</errorNumbers>  
+
   <inboundnumber>16047658410</inboundnumber>  
−
   </SMSSendMultipleResult>
+
   <carriercode>302720</carriercode>  
 +
  <messageid>Mail1300928784355-5</messageid>
 +
  </NewSMSMessage>
 +
 
  
  
−
'''Partial Success - some messages will not be sent (in the below example 2)'''
+
'''Result of method GetBottomMessage'''
 
----
 
----
 
   <?xml version="1.0" encoding="utf-8" ?>  
 
   <?xml version="1.0" encoding="utf-8" ?>  
−
- <SMSSendMultipleResult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms">
+
- <NewSMSMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms">
−
   <isOk>false</isOk>  
+
   <isValid>true</isValid>  
−
   <successCount>3</successCount>  
+
   <sender>+17788580767</sender>  
−
   <failedCount>2</failedCount>  
+
   <data>e test email command</data>  
−
   <errorMessages>recipient length invalid,recipient length invalid</errorMessages>  
+
   <name>taylorsun</name>  
−
   <errorNumbers>456789,123456</errorNumbers>  
+
   <inboundnumber>16047658410</inboundnumber>
−
   </SMSSendMultipleResult>
+
  <messageid>Mail1280535182021-4</messageid>  
 +
   </NewSMSMessage>

Revision as of 16:39, 5 May 2011

Collecting mobile originated messages from your account using SOAP methods is done using 4 available functions:

  • GetNewInboxCount - returns the number of new messages in your Inbox
  • GetNewInboxMessages - Gets new sms messages from your inbox (maximum 300). Upon collection, messages are set to "read"
  • GetTopMessage - Used to get the latest new sms message in inbox. Message flag is set to "read" after this function is completed
  • GetBottomMessage - Used to get the earliest new sms message in inbox. Message flag is set to "read" after this function is completed

Before you can use these functions you must obtain Token/Signature for your account. This is needed only once.


Results

Result of method GetNewInboxCount

<?xml version="1.0" encoding="utf-8" ?> <int xmlns="http://upsidewireless.com/webservice/sms">2</int>


Result of method GetNewInboxMessages 

 <?xml version="1.0" encoding="utf-8" ?>

- <ArrayOfNewSMSMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms"> - <NewSMSMessage> 

 <isValid>true</isValid> 
 <sender>+17788580767</sender> 
 e test email command 
 <name>username</name> 
 <inboundnumber>16047658410</inboundnumber> 
 <messageid>Mail1280535182021-4</messageid> 
 </NewSMSMessage>

- <NewSMSMessage> 

 <isValid>true</isValid> 
 <sender>+17788580767</sender> 
 test message 
 <name>username</name> 
 <inboundnumber>16047658410</inboundnumber> 
 <carriercode>302720</carriercode> 
 <messageid>Mail1300928784355-5</messageid> 
 </NewSMSMessage>
 </ArrayOfNewSMSMessage>


Result of method GetTopMessage 

 <?xml version="1.0" encoding="utf-8" ?>

- <NewSMSMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms"> 

 <isValid>true</isValid> 
 <sender>+17788580767</sender> 
 test message 
 <name>taylorsun</name> 
 <inboundnumber>16047658410</inboundnumber> 
 <carriercode>302720</carriercode> 
 <messageid>Mail1300928784355-5</messageid> 
 </NewSMSMessage>


Result of method GetBottomMessage 

 <?xml version="1.0" encoding="utf-8" ?>

- <NewSMSMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://upsidewireless.com/webservice/sms"> 

 <isValid>true</isValid> 
 <sender>+17788580767</sender> 
 e test email command 
 <name>taylorsun</name> 
 <inboundnumber>16047658410</inboundnumber> 
 <messageid>Mail1280535182021-4</messageid> 
 </NewSMSMessage>
Retrieved from "http://docs.upsidewireless.com/index.php?title=MO_SOAP&oldid=3255"