Posts Tagged ‘API’

API – Gerador de URLs

Sunday, February 15th, 2009

Depois de alguns pedidos, resolvi liberar uma API de geração de URLs do migre.me. Para utilizá-la, é simples! Basta enviar a URL para o endereço http://migre.me/api.xml?url=[ENDEREÇO], obviamente, substituindo o [ENDEREÇO] pela URL em questão.

Algumas coisas importantes:

1- A URL DEVE ESTAR EM FORMATO CODIFICADO, ou seja, somente com caracteres alfanuméricos. Durante a programação, basta codificar o endereço com alguma função que faz essa codificação. No caso do PHP, teriamos algo como:

<?php
// URL para compactar
$url=“http://videolog.uol.com.br/video.php?id=406097″;

// usando a função urlencode para codificar a URL
$codificado=urlencode($url);

// retornará
//http%3A%2F%2Fvideolog.uol.com.br%2Fvideo.php%3Fid%3D406097

echo $codificado;
?>

2- Existe um limite de 30 URLs no intervalo de 1 hora por IP para qualquer usuário (free).

3- O resultado será o seguinte:

<item>
<title>XML Migre.me</title>
<error>0</error>
<created_at>Sun, 15 Feb 2009 19:11:55 -0300</created_at>
<source>api</source>
<date>2009-02-15 19:11:55</date>
<id>19E</id>
<url>http://www.youtube.com/watch?v=btAaUZIhV6c</url>
<migre>http://migre.me/19E</migre>
<category>free</category>
</item>

title: O nome do arquivo (fixo)
error: pode ser 0, 1 ou 2.

0 – ausência de erro,
1 – Erro 1: Limite de 30 URLs por hora excedido. Por favor, aguarde alguns minutos
2 – Erro 2: A URL deve comecar por http:// https:// ou ftp://

creat_at: Data no formato RFC 2822
source: Quem está usando o API (fixo)
date: Data que a URL foi criada, no formato “YYYY-mm-dd HH:ii:ss”
id: o id de redirecionamento
url: a URL original
migre: a URL compactada (no formato http://migre.me/id)
category: free (gratuito), platinum (gratuito, + de 30 urls/hora) ou gold (pago, com outras funcionalidades)

A API está em fase de testes! Por favor, me relatem possiveis erros com os dados gerados, assim como produtos desenvolvidos e que utilizam a API do migre.me!

Abraço para todos!