E lá vamos nós mais uma vez para uma série de artigos. Após vários pedidos, vamos finalmente abordar a tão aclamada API do Facebook. Esse artigo vai se estender por, hum, tantas partes quanto necessárias. Ou até eu ficar sem paciência. Já aviso, este primeiro post será mais curto, mas em compensação, vou postar mais frequentemente, visto que temos que abordar várias facetas da API.

Iniciando a brincadeira

Antes de mais nada, para podermos brincar com qualquer recurso da API do Facebook, temos que necessariamente criar uma aplicação no Facebook. Para isso, seguimos os seguintes passos:

1. Acesse a página inicial de Apps do Facebook devidamente logado;
2. No canto direito superior, clique em + Create New App;
3. Dê um nome para a aplicação (e tente adivinhar o captcha);
4. Após isso, sua aplicação já está funcionando. Você pode adicionar uma imagem, alterar o nome. Mas por enquanto, somente isso já está ótimo.

Feito o cadastro, vamos precisar fazer o download da SDK do Facebook. Podemos fazer de duas maneiras:

• Clonando o repositório do GitHub (recomendado. Isso me lembra que tenho que fazer um artigo sobre Git)
• Fazendo o download do pacote via a url https://github.com/facebook/php-sdk/zipball/master

Com a aplicação registrada e a SDK em mãos, podemos realmente nos divertir

Configurando a SDK

Para configurar a SDK, vamos precisar somente de duas coisas: App ID e App Secret. Ambas informações estão disponíveis na administração da sua recem criada aplicação, em "Summary".

Eu criei uma aplicação chamada Paranoid Android e as informações dela são:

• App ID: 125178627581346
• App secret: 9fcc6b62c0f23c337d8ecb9aec27d155

Com essas informações em mãos, vamos ao que interessa!

Vamos criar um arquivo, vai se chamar index.php mesmo, estou sem imaginação, e colocamos o seguinte código nele:

    require 'facebook_sdk/facebook.php';
    $facebook = new Facebook(array(
        'appId'  => '125178627581346',
        'secret' => '9fcc6b62c0f23c337d8ecb9aec27d155'
    ));
    $kidh0 = $facebook->api('/henrique.boaventura');
    echo 'Nome: ' . $kidh0['name'];
    echo 'Localização ' . $kidh0['location']['name'];

Explicando:

• Linha 1: Requisita a biblioteca do Facebook;
• Linha 2: Criamos a instância da nossa aplicação, setando as informações da nossa aplicação (App ID e App secret);
• Linha 6: Faz a chamada para a API, requisitando o perfil público do usuário (aqui também pode ser o id do usuário);
• Linha 7 e 8: Exibimos algumas informações do usuário.

A API retorna um array para a variável (no caso $kidh0) com todas as informações públicas do usuário.

E é somente isso, com 6 linhas de código temos acesso ao perfil público de qualquer usuário (logicamente, desde que o usuário compartilhe o seu perfil).  

Para fazer o download do arquivo de exemplo (com HTML exibindo o perfil público do usuário), clique aqui.

Esse artigo foi bem curto, mas nos próximos, vamos nos aprofundar mais na API. See you there!

Links úteis:

• http://www.github.com/facebook/php-sdk
• https://developers.facebook.com/docs/reference/api/

Leia também:

1. PHP: Integrando o Facebook ao seu site – parte 2 – Atualizando o status do usuário
2. PHP: Integrando o Twitter ao seu Site – Autenticação de Usuários
3. PHP: Integrando o Twitter ao seu Site – Parte 3 (Agora com OAuth)
4. PHP: Integrando o Twitter ao seu Site – Parte 2