API Documentation

URLthat (pronounced 'earl-that') exposes its functionality via an Application Programming Interface (API). This document is a reference for that functionality and serves as a reference for developers building applications that integrate URLthat capabilities.

Authentication

All URLthat API methods require a free API key to authorize transactions. This key is used to identify specific applications that use the API. This has the added benefit of allowing us to promote your application on the site.

Parameters

All API methods take optional and/or requisite parameters. Those parameters have been documented for each method. Remember to convert to UTF-8 and URL encode parameters that take complex strings.

HTTP Requests

All API methods require a GET request. All responses will return UTF-8 encoded XML. Symbols and characters outside of the standard ASCII range are translated to HTML entities. All method URLs are case sensitive.

Rate Limiting

Currently there is no limit on requests to the API. Please use the system wisely so we don't have to place limits- you have been warned.

Methods

createUrl

Returns a URLthat url for the long url submitted.
URL: http://urlthat.com/createUrl.php
Parameters:

Example:: http://urlthat.com/createUrl.php?apiKey=f0951522d9&long
Url=http%3A%2F%2Fwww.myfamousblog.com%2Fsubdirectory%2FMoreStuff%2F

Response:

<response>
<urlthat>http://urlthat.com/aT4314Rd</urlthat>
<original>http://www.myfamousblog.com/subdirectory/MoreStuff/</original>
</response>