URL Ace
Home Services FAQ Terms Developers Contact Us

Developers

The URLAce.com API uses a REST-based interface. Our server responds to HTTP GET requests made over the Internet. All responses from our server through the API will be in an XML format.

With our API, you can generate short URL's that you can use for any purpose. You are allowed to use the API for commercial and non-commercial uses. Access to the API is free.



API Usage

The url used to access the API is:

http://www.urlace.com/api.php

You must also append one or more URL's to the API request. For example, the following request has one URL.

http://www.urlace.com/api.php?url1=http://www.cnn.com/

The response from our server will always be in XML. The response for the above example will be:

<?xml version="1.0" encoding="utf-8" ?>
<response>
<short_url>http://urlace.com/xxxx</short_url>
</response>

Where you see "xxxx" in the XML is where the server will return your unique code for the URL(s) entered.

You may send up to five URL's in the request. More then one URL makes it a short URL rotator.

The only parameters you can include are url1, url2, url3, url4, and url5.



API Errors

If the URL's you include in the request are invalid, you will receive the following response:

<?xml version="1.0" encoding="utf-8" ?>
<response>
<error>true</error>
</response>

You must always include at least one URL, and every included URL must be valid. To be valid, they must begin with "http://" or "https://" and they may not include "urlace.com" in it.



API Help

If you need help with the API, you may send e-mail to support@urlace.com.