XR API

The XR API is now open. You send us an http request including a minimum of the URL that you want to shorten. You can include a few optional items to add lots of flexibility.

Calls sent to: api.xr.com/api?
Minimum definition: link=http://www.cbc.ca/canada/british-columbia/story/2008/02/27/bc-condosintrouble.html

Optional definitions:
&pid={account name} <--- adds the link to your account so you can manage it and view stats
&domain={domain other than xr.com} <---- use x.bb or your own domain or subdomain (so long as they are CNAME'd to xr.com)
&raw=yes (or y or t or true) <---- will give you just the alias and not the full shortened URL.
&custom={custom tag} <--- if you'd like to define the alias and not just get back a random, short alias
&direct=yes (or y or t or true) <---- will have the destination URL show up in the address bar with no top frame or preview page

Examples:

This link is created and a response given - not added to an account:
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html
Response: http://xr.com/kwle

This link is created and added to the account: angelwings:
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&pid=angelwings
Response: http://xr.com/kwle

This link is created and added to the account: angelwings under the domain x.bb :
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&pid=angelwings&domain=x.bb
Response: http://x.bb/kwle

This link is created with a custom tag:
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&custom=aug282008
Response: http://xr.com/aug282008 (or ERRORTAKEN)

This link is created, added to the account: angelwings under the domain x.bb :
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&pid=angelwings&domain=x.bb&custom=aug282008
Response: http://links.ydownload.com/aug282008 (or ERRORTAKEN)

This link is created, added to the account: angelwings under the domain x.bb and will not have a frame:
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&pid=angelwings&domain=x.bb&custom=aug282008&direct=t
Response: http://links.ydownload.com/aug282008 (or ERRORTAKEN)

This link is created but just the raw tag is returned):
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&raw=y
Response: kwle

This link is created, with just the raw custom tag returned):
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&custom=aug282008&raw=y
Response: aug282008 (or ERRORTAKEN)

This link is created, added to the account: angelwings under the domain x.bb with just the raw tag returned:
http://api.xr.com/api?link=http://www.example.com/longdirectory/somepage.html&pid=angelwings&domain=x.bb&raw=y
Response: kwle