SystorSMS Web Service

SystorSMS

Click here for a complete list of operations.

CsvUpload

Upload a csv file with one or more sms using a POST call. Messages with invalid receiver or empty message text will not be sent.

Please add the following parameters:
sUser Account username. This field is required. String.
sPass Account password. This field is required. String.

File format:
Each line should contain a receiver, an originator and a message. These values should be seperated by a tab character (and not multiple spaces).
There should not be more than two tab characters per line. Empty lines will be ignored. (Line endings can be ENTER, \n or \r\n.)

receiver The recipient's phone number.
originator The SMS originator. If an illegal originator is used, then the system will use an originator registered to your account or 26001
message Only the first 1530 characters of the message text will be sent. Use the character ¤ to create new lines within the message text.

Example csv file :
41109511 SystorVest This is the message text¤This part of the text will be placed on a new line
123 SystorVest The receiver is not a valid mobile number. This message will be rejected.

The first line will send a sms to mobile number 41109511 with the text "This is the message text". The sender will be SystorVest.
The second line does not have a valid receiver and the message will not be sent.
Note that the example above uses multiple spaces and not the required tab character.

Curl example:
curl -X POST "https://smsalert.no/systorsmsvarious/systorsmsvarious.asmx/CsvUpload" -F "data=@sms.csv" -F "sUser=myuser" -F "sPass=mypassword" -H "Content-Type: multipart/form-data" >> "log.txt"

Return value for the previous example:
File received 2019-05-24T12:49:40Z: sms.csv
(Lines with errors are displayed first.)

Status: Message not sent
Error: Invalid receiver.
Receiver: 123
Originator: SystorVest
Message: The receiver is not a valid mobile number. This message will be rejected.

Status: Message sent
Receiver: 41109511
Originator: SystorVest
Message: This is the message text.¤This part of the text will be placed on a new line

Messages sent: 1

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /systorsmsvarious/systorsmsvarious.asmx HTTP/1.1
Host: smsalert.no
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.systorvest.no/CsvUpload"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CsvUpload xmlns="http://www.systorvest.no/" />
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CsvUploadResponse xmlns="http://www.systorvest.no/">
      <CsvUploadResult>string</CsvUploadResult>
    </CsvUploadResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /systorsmsvarious/systorsmsvarious.asmx HTTP/1.1
Host: smsalert.no
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <CsvUpload xmlns="http://www.systorvest.no/" />
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <CsvUploadResponse xmlns="http://www.systorvest.no/">
      <CsvUploadResult>string</CsvUploadResult>
    </CsvUploadResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /systorsmsvarious/systorsmsvarious.asmx/CsvUpload? HTTP/1.1
Host: smsalert.no

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://www.systorvest.no/">string</string>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /systorsmsvarious/systorsmsvarious.asmx/CsvUpload HTTP/1.1
Host: smsalert.no
Content-Type: application/x-www-form-urlencoded
Content-Length: length

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://www.systorvest.no/">string</string>