InteleServiceStack

<back to all web services

RestSmsRequest

RestSmsRequest Parameters:
NameParameterData TypeRequiredDescription
UsernameformstringYesAPI Username. Usually your customer id
PasswordformstringYesAPI Password
MessagesformRestSmsMessageReq[]YesCollection of messages to send
RestSmsMessageReq Parameters:
NameParameterData TypeRequiredDescription
GatewayformintegerYesGateway number. Default 99700999 for cross country delivery, non premium messages
OriginatorAddressformstringNoOriginator address. Defaults to gateway number if not set. Maximum 11 chars if using alphanumeric value. See documentation for full details.
DestinationAddressformintegerYesDestination address.The recipient of the message. Must be a valid MSISDN
PriceformintegerYesPrice to bill recipient. Premium messaging. Leave value to 0 if not using premium. Premium is only available on short number gateway number for each country available in documentation
MessageTypeformstringNoMessage type according to documentation. Defaults to 00 if not set. If text length is above 160 chars, it defaults to value 11
ValidationPeriodformstringNoDelivery expire timestamp (yyyymmddhhmmss) or relative value. See documentation and default value if not defined
MessageIdformstringNoYour unique message id to track delivery status and response from sending process
UserDataHeaderformstringNoGSM User Data Header (HEX)
UserDataformstringYesGSM User Data. Plain text or hex encoded. Depending on the used MessageType
CategoryformstringNoParameter to categorize messages on payment bill from Intele
CustomDataformstringNoCustom key/value attributes for the Sms Text Message. See documentation for further details
DeliveryReportUrlformstringNoUrl where Intele should send delivery report. See documentation for url formatting
ServiceCodeformstringNoFor Premium messaging only. See documentation for further details
ServiceDescriptionformstringNoFor Premium messaging only. See documentation for further details
RestSmsResponse Parameters:
NameParameterData TypeRequiredDescription
ProcessResultformbooleanYesOverall status of processing the request. Each message will have it's own status. This value indicates if any other error occured or not
ProcessResultDescriptionformstringNoDescription of any error occured, if ProcessResult equals false
MessagesformRestSmsMessageResp[]YesCollection of messages sent or failed
RestSmsMessageResp Parameters:
NameParameterData TypeRequiredDescription
StatusCodeformintegerYesResult of sending message. 0 if success. See documentation for full list of codes
StatusDescriptionformstringYesDescribes the result of sending Sms text message
MessageIdformstringNoYour unique message id from send request message item. Will be empty if you did not provide any id in the request item.
TransactionIdformstringYesUnique transaction id from server
ExtraInfoformstringNoKey/Value attributes returned from server. E.g. subnumref and the server name that processed the message. Eg. subnumref=19331234567891,server=smsgw1

To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /jsonl/reply/RestSmsRequest HTTP/1.1 
Host: smsgw.intele.no 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"Username":{},"Password":"String","Messages":[{"Gateway":{},"OriginatorAddress":{},"DestinationAddress":{},"Price":{},"MessageType":"String","ValidationPeriod":{},"MessageId":"String","UserDataHeader":"String","UserData":"String","Category":"String","CustomData":{"String":{}},"DeliveryReportUrl":"String","ServiceCode":"String","ServiceDescription":"String"}]}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"ProcessResult":false,"ProcessResultDescription":"String","Messages":[{"StatusCode":0,"StatusDescription":"String","MessageId":"String","TransactionId":"String","ExtraInfo":{"String":"String"}}]}