HTTP GET/POST

«aql messaging services» «aql voice services»


HTTP GET/POST

Account Login

Lost password?

	aql ®
	Award Winning Service

	aql Telecoms
	Click here to view aql's range of voice fax and Business Voice over IP telephony solutions

	New Accounts
	Signup for a starter account from only £6+VAT. If you are a business user, apply here for a free trial account

Variables

The following variables will be sent to your script via HTTP POST or GET upon a message being delivered to you. If you can design your script to listen out for the variables below:

Name	Data
gwNumber	The destination number
originator	The sender's number
message	The message body
smsTime	Time when the sms was sent Format: YYYY-MM-DD HH:MM:SS
timeZone	An integer, indicating time zone (eg: if timeZone is 1 then it means smsTime is GMT + 1)
network	Name of the originating network. Will be replaced with an SMSC reference number if the network is not recognised
id	A unique identifier for the message
time	Time the message received by aql (UK time) Format: YYYY-MM-DD HH:MM:SS
coding	Message coding 7 (normal), 8 (binary) or 16 (unicode)
status	0 - Normal Message 1 - Concatenated message, sent unconcatenated 2 - Indecipherable UDH (possibly corrupt message)

Please note that we expect the originator ID to be in a numeric format, rather than alphanumeric, however this should not affect the majority of senders

Technical

Verification with variable

You can set a verification variable to protect your script from spamming. You can use this to check whether the inbound data was sent to your virtual mobile number.

Our example script assumes that you have set a variable verify=aql in your destination URL, e.g your virtual mobile number points to http://192.168.1.100/script.php?verify=aql

Failover with multiple destinations

You can set multiple destinations to your virtual mobile number. This can be used to failover and ensure the inbound data will reach your script. For example if you have set two destinations http://192.168.1.100/script1.php and http://192.168.200/script2.php our system will first try to HTTP POST/GET request to script1.php and failing that the data will be delivered to script2.php

Placeholders

If no GET variables specified we will pass the following:

Variable	Placeholder	Format
status	%stat
gwNumber	%dest
originator	%orig
message	%msg
time	%time	YYYY-MM-DD HH:MM:SS
smsTime	%smsTime	YYYY-MM-DD HH:MM:SS
timeZone	%smsTimeZone
network	%netw
coding	%code
id	%id

or can pass some of the above and those below to your own parameter names depending on your requirements.

Placeholder Format

%unixRcvTime

%smscTime YYYY-MM-DD HH:MM:SS

%smscTimeZone

%origTon

%origNpi

%destTon

%destNpi

%smscRef

%pid

%addInfo

%udh

%dcs

e.g http://192.168.1.100/script.php?originator=%orig&timezone=%smsTimeZone

Example Code

Here are some examples of code that can be used with HTTP GET/POST: