|
Support @ smsCentral
XML: SMSQuery Function
Below are the specifications for the Login
method of the smsCentral XML solution. Including linking requirements
and field explanations.
The following table outlines the XML sent and
received from the smsCentral XML page:
|
The following is an
example of the XML sent to the smsCentral XML Page; |
<QuerySMS>
<TransactionID>test@smscentral.com.au</TransactionID> <Username>test@smscentral.com.au</Username>
<Password>test1234</Password>
</QuerySMS> |
|
The following is an
example of the XML returned after a successfull
transaction; |
<smsResponse>
<smsFrom>smsCentral</smsFrom>
<smsNumbers></smsNumbers>
<smsMessage></smsMessage>
<smsNumbersCount>0</smsNumbersCount> <smsPerTransactionCost>0</smsPerTransactionCost>
<smsTotalCost>0</smsTotalCost>
<status>True</status>
<statusID>1</statusID>
<errormessage>Delievered</errormessage>
<transactionID>38674298</transactionID>
</smsResponse> |
The following tables
outline the maximum string lengths that can be passed to the
smsCentral XML page. If data is passed of a greater length then
it is ignored.
|
Field Name |
Maximum Field Length (characters) |
Required Field |
|
TransactionID |
8 |
 |
|
Username |
50 |
|
|
Password |
50 |
|
The following table gives a description of all
the fields involved in the QuerySMS function.
|
Field Name |
Description |
|
TransactionID |
A unique identifier for each SMS, enabling
you to look up the status of an SMS. |
|
Username |
Enables to access SMSCentral. |
|
Password |
Enables to access SMSCentral. |
|
smsID |
The unique identifier
of the message that you sent. Each message is assigned its own
identifier. |
|
smsFrom |
The text that appeared in the from text of
your message. |
|
smsNumbers |
A list of the mobile numbers the SMS was
sent to. |
|
smsMessage |
The SMS that was sent to the selected
mobiles. |
|
smsNumbersCount |
The number of mobiles the message was sent
to. |
|
smsPerTransactionCost |
The cost in credits of each individual message. |
|
smsTotalCost |
The total cost of the transaction.
smsTotalCost = smsNumbersCount * smsPerTransactionCost. |
|
status |
The result of the SMS, ie True or False. |
|
statusID |
An ID indicating the status of the SMS,
0=pending, 1=delivered, 2=failed, 3=error |
|
errormessage |
Possible error message ie no such number. |
Return to smsCentral support
|
