API complete for all projects
For developers, we created an API complete and easy
to use of the redirector. Ready for your projects, or where applications
need! Some features are listed below. If you need something new, be
sure to ask, will be created within three days.
Create Link (simple)
http://uiop.me/api/newlink.php?u=http://www.argohost.net/
(plain text)
Simple function to create a url. Open the page with the link you want
to shorter, in format url encoded (urlencode in php). The return will
be link shortened, beautiful and ready to be crawled. If you want
a private link, add the parameter
&private=1 in order
for it does not display statistics.
Destination of the URL (simple)
http://uiop.me/api/location.php?u=1
(plain text)
A function that returns only the destination of a url. Good for those
who need a quick way to find the location of a url, but without working
with xml.
Everything on a URL
http://uiop.me/api/infourl.axml?u=1
(xml)
More complete, it returns an XML with more information to the url
http://uiop.me/1. To be more exact: the page that link points out,
unique clicks the link has, how many times was twited, if is private
link, date of creation and format in time(). If you want information
from their links created , see last50.axml
Export the URL clicks
http://uiop.me/api/clicks.axml?u=1
(xml)
For lover of statistics, this is the best function. It exports the
clicks of your URL (ascending order) in XML. For each click is displayed:
date, time, referer, useragent, browser, operating systems, city,
state, country and country code.
Attention to the location of click: It may appear only after 10 minutes
of the click. In this case, it is exported blank. Some minutes later,
if called again, has been available. If you want only the number of
clicks, use the file infourl.axml. He also returns some data of the
link.
Discover the tweets of a URL
http://uiop.me/api/tweets.axml?u=1
(xml)
This is another function for those who need more statistics of its
url. It returns all tweets and retweets a link. The format is in XML,
with the following information: @author of Tweet, Tweet's content,
the html Tweet(with links), when it was created, status (twitter.com/user/status/xxxx)
and if is Tweet or retweet.
The 50 latest urls created from your IP
http://uiop.me/api/last50.axml
(xml)
Like infourl.axml, it also returns the information of the link, but
in all 50 last links created by your server. If you need information
from only one link, see infourl.axml.
50 latest links posted by someone on Twitter
http://uiop.me/api/twitter50.axml?u=edudebastiani
(xml)
Lets see the last 50 links twited / retwited by any person on Twitter.
Returns various information of each Tweet, such as: content (with
and without html), date, status and if is retweet, showing the user
of original tweet. With information of the URL: url, page that redirect,
clicks, number of times twited and date of creation.
Limits of API
http://uiop.me/api/remain.axml
(xml)
The API has a limit on requests to prevent spam bots from the server
overload, damaging the other developers. The limits are: up to 30
url creation per hour and request to 100 pages of content every hour.
Controlled by the IP.
If your application needs to create more links or more
queries, just send a message saying what your
project, and what the server ip limit will need. All applications are
read and approved within 24 hours. In remain.axml you can see the remainder
requests.
How to use the API
The method for using the API is very simple and
easy. Can be done with a few lines in any language that has Internet
access, such as PHP, javascript, asp, java, Action Script and C.
In PHP, the simplest way is through the file_get_contents().
There is also the possibility to integrate it with the Curl or other
classes you want. See how easy it is to create a redirect in just 6
lines: http://uiopme.pastebin.com/f28fddf38.
Gallery
Send the logo and url of your application by email, it will be added
in future mini-gallery of applications using the API. Its application
is essential in it!
