Acesso ao API de bit.ly em PHP

Vejamos um script PHP que consome dados do API de bit.ly. Neste caso vamos mostrar como encurtar uma URL em PHP utilizando este serviço web.

Por Miguel Angel Alvarez - Tradução de Celeste Veiga


Publicado em: 15/9/10
Valorize este artigo:
Nos artigos anteriores do Manual do API de bit.ly que estamos publicando em CriarWeb.com já oferecemos notas iniciais sobre as possibilidades do API de bit.ly, que nos permite encurtar URLs e obter informação sobre URLs curtas que foram geradas utilizando este serviço web.

Agora, vamos começar a fazer coisas mais práticas e divertidas. Neste caso se trata de fazer um script PHP que se conecte com o API, para enviar uma URL longa e obter uma curta. Como veremos neste artigo, é uma tarefa bastante simples, embora demande vários passos, que listamos a seguir.

  1. Fazer uma URL para a consulta no API de bit.ly
  2. Acessar essa URL por meio de PHP e receber a informação em formato JSON
  3. Converter o JSON resultante em um array associativo de PHP
  4. Acessar os dados que necessitemos, ou seja a URL curta gerada por bit.ly
O código do exemplo básico de uso do API de bit. em PHP que criamos é o seguinte:

//umas variáveis de configuração
$servico_web = "http://api.bit.ly/";
$versao_API = "versao=2.0.1";
$usuario = "login=usuario"; //substitui por seu usuario do API
$chave = "apiKey=R_000000"; //substitui por sua chave do API

//a URL que quero acurtar
$URL_longa = "http://www.criarweb.com/manuais/";

//codifico em formato de URL a URL longa
$query_URL = "&longUrl=" . urlencode("http://www.criarweb.com/manuais/");

//gero a URL para consultar no API de bit.ly
$URL_consulta_API = $servico_web . "shorten?" . $version_API . "&" . $query_URL . "&" . $usuario . "&" . $chave;

//leio o que me devolve o API ao fazer essa consulta, que estará em formato JSON
$resposta_API = file_get_contents($URL_consulta_API);

//agora tenho que consumir esse JSON para converte-lo em uma estrutura de dados acessível desde PHP
$resposta_API = json_decode($resposta_API, true);
//o true anterior faz com que json_decode me devolva um array associativo.

//agora poderíamos mostrar o conteúdo completo da resposta.
echo "<pre>";
var_dump($resposta_API);
echo "</pre>";

//comprovo se houve algum problema
if($resposta_API["errorMessage"]==""){
   //Tudo bem, pois não há erros
   //mostro a URL curta gerada pelo API
   echo $resposta_API["results"][$URL_longa]["shortUrl"];
}else{
   echo "Houve um erro";
}

Com isto temos pronto um exemplo de uso do API, que esperamos possa ter sido entendido através dos comentários. Lembre-se de substituir por seus próprios dados, tanto o usuário e a chave do API quanto a URL que você queira encurtar com bit.ly.

Como se pode comprovar, a tarefa não é nada complicada, embora possa ser ainda más fácil, como veremos no artigo seguinte, no qual explicaremos e daremos exemplos de uma classe PHP, de programação orientada a objetos, que existe para acessar o API de bit.ly de uma maneira mais cômoda.






Usuários :    login / registro

Manuais relacionados
Categorias relacionadas
O autor

Home | Sobre nós | Copyright | Anuncie | Entrar em contato