Jump to content

This is the support site for Andrews & Arnold Ltd, a UK Internet provider. Information on these pages is generally for our customers but may be useful to others, enjoy!

SMS API: Difference between revisions

 
(4 intermediate revisions by the same user not shown)
 
We support UTF-8 coding of the full GSM 7 bit character set (including £$¥èéùìòÇØøÅåΔ_ΦΓΛΩΠΨΣΘΞÆæÉÄÖÑܧäöñüà€¡¿) and from UCS16 messages and UTF-16 surrogates. Not all of our SMS interconnects handle all of the coding, so we send the message as best we can.
 
example:
https://your.domain/yourscript.ext
 
===SIM===
We operate an outbound text service that is available to all of our customers that have a VoIP number. To use this service you must have an outgoing password configured in the control pages for the VoIP number.
 
ToOur sendSMS textsgateway you need to issue an HTTP POST to our outbound text gatewayis https://sms.aa.net.uk/sms.cgi and uses with the following fields as if sent from a form. As the password is sent in plain text you may prefer to use https.
*These can be sent as a URL encoded form data GET
*These can be sent as a URL encoded form data POST
*These can be sent as fields in a POST of a JSON object
 
{|class="wikitable"
|-
| ''private''
| Marks the message as private, seesuch belowthat it is not included in the itemises billing.
|-
| ''oa''
| Email address or URL for delivery report, see below
|}
Note that we have, again, tried to use GSM 03.40 field names, but alternative field names are supported for now: ''destination'', ''originator'', ''message''.
 
We support UTF-8 coding of the full GSM 7 bit character set (including £$¥èéùìòÇØøÅåΔ_ΦΓΛΩΠΨΣΘΞÆæÉÄÖÑܧäöñüà€¡¿). Whilst one message is normally up to 160 characters some characters are coded using two characters using an ESC prefix in the 7 bit alphabet (€,[,\,],^,{,|,},~). The message will be coded as 7, 8 or 16 bit depending on what you include in the text, and this will impact the number of message parts that may be sent. If you include the invalid UTF-8 sequence 0xC0 0x80, then that includes a null in the message. If you include any unicode characters beyond U+0xFFFF then UTF-16 coding is used and sending of text in is UCS2 format. Not all interconnects or devices understand UTF-16 format.
The response text starts either ERR: and an error message or OK:
 
You can choose to have a response back in XML - this makes the service more compatible with Acrobits' Groundwire mobile phone app that is a softphone with SMS capability. AddInclude a field called xml, e.g. add &xml to the URL for a GET.
 
===Example===