SMS    Telecoms
 
»Sign Up     »Contact Us  
 
 
       

Create vCards using HTTP


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




Use an http request to generate and send a vCard

Specify your vCard information and send it using HTTP POST or GET.
Our system will create the vCard and transmit it to it's destination.

Your vCard must include

Destination number (the API can handle most common number formats - +447xxx xxxxxx
Originator (16 numeric characters or 11 alphanumeric characters)
Forename
Surname

You can also include

Preferred contact number
Mobile phone number
Home phone number
Work phone number
Fax number
Email address
Address
Note

Complete with error and credit usage reporting

HTTP fields

AQL Usernameusername
AQL Passwordpassword
Destinationdestination
Originatororiginator
Forenameform_fname
Surnameform_lname
Preferred numberform_pref
Mobile numberform_mobile
Home numberform_home
Work numberform_work
Fax numberform_fax
PTT numberform_ptt
Email addressform_email
Addressform_label
Noteform_note

Example implementation

<html>
<head>
<title>aql vCard generator</title>
</head>
<body>
<form action=http://gw1.aql.com/sms/gw-vcard.php method=post>
<input type=hidden name=action value=send>
<table>
<tr><td>AQL Username</td><td><input type=text name=username></td></tr>
<tr><td>AQL Password</td><td><input type=password name=password></td></tr>
<tr><td>Destination</td><td><input type=text name=destination></td></tr>
<tr><td>Originator</td><td><input type=text name=originator></td></tr>
<tr><td>Forename</td><td><input type=text name=form_fname></td></tr>
<tr><td>Surname</td><td><input type=text name=form_lname></td></tr>
<tr><td>Preferred number</td><td><input type=text name=form_pref></td></tr>
<tr><td>Mobile number</td><td><input type=text name=form_mobile></td></tr>
<tr><td>Home number</td><td><input type=text name=form_home></td></tr>
<tr><td>Work number</td><td><input type=text name=form_work></td></tr>
<tr><td>Fax number</td><td><input type=text name=form_fax></td></tr>
<tr><td>PTT number</td><td><input type=text name=form_ptt></td></tr>
<tr><td>Email address</td><td><input type=text name=form_email></td></tr>
<tr><td>Address</td><td><input type=text name=form_label></td></tr>
<tr><td>Note</td><td><input type=text name=form_note></td></tr>
<tr><td>&nbsp;</td>< td><input type=submit></td></tr>
</table>
</form>
</body>
</html>

Please feel free to try and send a vCard


System responses

GW-OK:Message sent, number of credits used reported
GW-NO_AUTH_DETAILSAuthentication error : Username and password required
GW-AUTH_ERRORAuthentication error : Username and password mismatch
GW-NO_DESTINATIONDestination field contains no data
GW-INVALID_DESTINATIONDestination field contains non-numeric data
GW-MSGERRORMessage could not be sent
GW-NO_CREDITAQL account has insufficient credit(s). If a message comprises more than 160 characters, several credits will be used as we will need to send several concatenated messages.
GW-ERROR:Other error, non-acknowledged messages reported
©1999-2008 aql ® Peer with aql | Home | Site Map | Sign Up | Contact Us | Terms of Service | Privacy Policy