API completa para todos os projetos

Criar Link (simples)

http://uiop.me/api/newlink.php?u=http://www.argohost.net/ (plain text)
Função simples para criar uma url. O único trabalho necessária é abrir a página passando por referência o link que deseja encurtar, codificado para url (urlencode do php). O retorno será com o link encurtado, bonito e pronto para ser rastreado. Caso queira um link privado, adicione o parâmetro &privado=1 no fim, para ele não exibir as estatísticas.

Destino da URL (simples)

http://uiop.me/api/location.php?u=D (plain text)
Uma função que retorna apenas o destino de uma url. Bom para quem precisa de uma maneira rápida para achar a localização de uma url, mas sem precisar trabalhar com xml.

Tudo sobre uma URL

http://uiop.me/api/infourl.axml?u=D (xml)
Mais completa, retorna um XML com várias informações para a url http://uiop.me/D. Para ser mais exato: página que o link aponta, cliques únicos que o link possui, quantas vezes foi "twitado", se é um link privado, qual a data de criação e o formato da data em time(). Se quiser informações do seus últimos links, veja last50.axml

Exportar os cliques da URL

http://uiop.me/api/clicks.axml?u=D (xml)
Para quem gosta de estatísticas, esta é a melhor função. Ela exporta os cliques da sua URL (ordenação ascendente) em XML. Para cada clique é mostrado: Data, time, referer, useragent, navegador, sistema operaciona, cidade, estado, país e código do país.

Atenção para a localização geográfica: Pode aparecer somente após 10 minutos do clique. Neste caso, ela é exportada em branco. Alguns minutos depois, se chamado novamente, já vem disponível. Se você quiser apenas o número de clicks, use o arquivo infourl.axml. Ele retorna também alguns dados do link.

Descobrir os tweets de uma URL

http://uiop.me/api/tweets.axml?u=D (xml)
Esta é outra função legal para quem precisa de mais estatísticas do seu link. Ela retorna todos os tweets e retweets de um link. O formato é em xml, com as seguintes informações: @autor do tweet, conteúdo do tweet, html do tweet (com links), data em que foi criado, status (twitter.com/usuario/status/xxxx) e se é tweet ou retweet.

Os 50 últimos links do seu IP

http://uiop.me/api/last50.axml (xml)
Assim como a infourl.axml, este retorna também as informações do link, mas de todos os 50 últimos links criados pelo seu servidor. Se precisar informações de apenas um link, veja o infourl.axml.

50 últimos links postados por alguém no Twitter

http://uiop.me/api/twitter50.axml?u=edudebastiani (xml)
Permite ver os últimos 50 links twitados/retwitados por qualquer pessoa no Twitter. Retorna várias informações de cada tweet, como: conteúdo (com e sem html), data, status e se está retuitando de alguém. Com algumas informações da URL: url, página que aponta, clicks, vezes que foi twitada e data de criação.

Limites da API

http://uiop.me/api/remain.axml (xml)
A API possui um limite de pedidos para evitar que bots de spam sobrecarreguem o servidor, prejudicando os desenvolvedores. Os limites são: criar até 30 redirecionamentos por hora e requisitar até 100 páginas de conteúdo em cada hora. Ambos controlados pelo IP.

Caso a sua aplicação precisa criar mais links ou fazer mais consultas, apenas envie uma mensagem falando qual é o seu projeto, ip do servidor e qual limite irá precisar. Todos os pedidos são lidos e aprovados em até 24h. Pelo arquivo remain.axml é possível ver o limite e as consutas restantes.

Como usar a API

No PHP, a maneira mais simples é através do file_get_contents(). Também existe a possibilidade de integrá-la com o cURL ou outras classes que você quiser. Veja como é fácil criar um redirecionamento em apenas 6 linhas: http://uiopme.pastebin.com/f56af4807.