Text us or call us on : 011 33 20 30 40

vCard API

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