delphiki - Lack of Inpiration

Poster sur le mur d'une Fan Page via l'API Graph de Facebook

Wed, 19 Oct 2011 15:01:11 GMT

M�J du 7 d�cembre 2011 : modification de la partie sur la r�cup�ration de l'access_token, ce qui corrige le probl�me o� seul l'administrateur de la page pouvait voir les messages post�s. Les sources ont �t� mises � jour en cons�quence. Note : Ce tutoriel est une mise � jour de celui que j'avais fait il y a bient�t un an, utilisant l'API REST de Facebook. Mon ancien tutoriel n'�tant plus valable (on ne peut plus autoriser une application sur une page de la mani�re dont je l'ai d�crite), je vous fait part aujourd'hui de la nouvelle fa�on de proc�der pour arriver au m�me r�sultat : poster un message sur le mur d'une Fan Page en utilisant l'API ("Graph" cette fois) de Facebook. Je consid�re que vous avez d�j� cr�� votre page ou que vous �tes administrateur de la page sur laquelle vous voulez poster.

Pr�requis

Avant tout, vous devez t�l�charger le SDK PHP de Facebook qui permet de manipuler l'API Graph, directement sur GitHub. Vous pouvez t�l�charger le SDK soit via Git :

git clone https://github.com/facebook/php-sdk.git

Ou sous forme d'archive sur cette page. Les seuls fichiers dont nous avons besoin sont les fichiers du dossier src.

Cr�ation de l'application

Nous allons commencer par cr�er et configurer l'application qui vous servira d'interm�diaire entre vos scripts PHP et votre Fan Page. Dans un premier temps, allez sur cette page et cliquez sur Cr�er une application. Choisissez un nom et un namespace comme bon vous semble (le namespace est unique, si une autre application a le m�me, Facebook vous demandera d'un choisir un autre).

On vous demandera de remplir un CAPTCHA, puis vous devriez atterrir sur une page semblable � celle-ci :

R�cup�ration de l'� access token �

Si vous voulez que votre application puisse poster sur le mur de votre page, il faut que cette derni�re y soit autoris�e. Pour cela, il faut r�cup�rer ce qu'on appelle un � access token �. Il s'agit d'une cl� permettant d'authentifier l'application aupr�s de la page. Pour r�cup�rer cette cl�, voici la marche � suivre. Commencez par cr�er un fichier PHP (que j'ai appel� get_token.php) qui inclut les fichiers du SDK PHP de Facebook et qui contient quelques param�tres de configuration :

/* on inclut le fichier du SDK */
require_once('php-sdk/facebook.php');

/* l'id et la cl� secr�te de votre application sont disponibles sur la page de configuration de celle-ci */
$app_config = array(
  'appId' => 'APP_ID', 
  'secret' => 'APP_SECRET',
  'cookie' => true
);
/* Pour connaitre l'id de votre page, allez sur celle-ci et regardez son URL : https://www.facebook.com/pages//  */
$page_config = array(
  'page_id' => 'PAGE_ID'
);

Ajoutez ensuite ces quelques lignes (les explications sont dans les commentaires) :

$facebook = new Facebook($app_config);
/* on r�cup�re les informations de l'utilisateur connect� � Facebook */
$user = $facebook->getUser();

/* si connect� */
if($user){
  try{
    $accounts = $facebook->api('/me/accounts');
    echo '';
    print_r($accounts); /* on affiche les informations retourn�es */
  }
  catch (FacebookApiException $e){
    error_log($e);
    $user = null;
  }
}

if($user){
  $logoutUrl = $facebook->getLogoutUrl();
  echo 'Log Out';
}
else{
  $login_params = array(
    'scope' => 'manage_pages,publish_stream,offline_access' /* param�tres permettant de r�cup�rer le token, offline_access permet d'utiliser le token m�me si vous n'�tes pas connect� directement (ex. : avec un cron) */
  );
  $loginUrl = $facebook->getLoginUrl($login_params);
  echo 'Login';
}


Avant de lancer ce script, il faut d'abord sp�cifier l'URL de votre script PHP dans les param�tres de votre application.
Pour cela, retournez sur la page de configuration de votre application, et remplissez correctement le champ Site web, comme ceci :


Ceci indique sur quelle URL retourner apr�s avoir autoris� l'application.
Je n'ai pas test�, cependant je pense que une adresse en http://localhost/ devrait fonctionner.

Il est maintenant temps de vous rendre sur votre page PHP.
Si tout se passe bien, vous devriez avoir un lien Login, cliquez dessus.
Vous devriez atterrir sur cette page, cliquez sur Connexion :

Puis celle-ci, cliquez sur Autoriser :


Une fois ces �tapes effectu�es, vous avez correctement autoris� la gestion de votre page, par votre application, et vous �tes redirig� vers votre script PHP, qui devrait vous afficher votre access token (une tr�s longue chaine de caract�res) !

Array
(
  [data] = Array
    (
      [0] = Array
        (
          [name] = Tuto Graph API page
          [access_token] = VotreAccessTokenQuiEstUneTresLongueChaineDeCaracteres
          [category] = Tv channel
          [id] = 304493389565701
        )
        /* ... */
    )
)


Et voil�, le tour est jou�, vous avez d�sormais r�cup�r� le token qui vous permettra de poster sur votre page.
Voyons maintenant comment l'utiliser.

Poster un message sur la Fan Page
Rien de plus simple si vous avez d�j� lu mon tuto pr�c�dent.

Reprenez les param�tres de votre application et de votre page, sans oublier votre token :
require_once('php-sdk/facebook.php');

$app_config = array(
  'appId' => 'APP_ID',
  'secret' => 'APP_SECRET'
);
$page_config = array(
  'access_token' => 'ACCESS_TOKEN', /* n'oubliez pas cette entr�e par rapport au tableau dans get_token.php */
  'page_id' => 'PAGE_ID'
);

$facebook = new Facebook($app_config);


Puis rajoutez ces quelques lignes, qui suffisent � poster le message :
$params = array(
  'access_token' => $page_config['access_token'],
  'message' => 'Message de test',
  'name' => 'Nom de test',
  'caption' => 'L�gende de test',
  'link' => 'http://www.google.fr',
  'description' => 'Description de mon message !',
  'picture' => 'http://www.informanews.net/imagenews/panasonicTV_Google.jpg',
  'actions' => array(
    array('name' => "Nom de l'action", 'link' => 'http://www.google.fr/')
  )
);

$post_id = $facebook->api('/'.$page_config['page_id'].'/feed','post',$params);


Vous n'avez plus qu'� aller sur votre fan page pour admirer le r�sultat ! :)

Les scripts que j'utilise dans ce tuto sont disponibles � cette adresse pour les fain�ants.

Si vous avez des questions, les commentaires sont l� pour �a, ou bien @delphiki.

Amusez-vous bien. ;-)

Du nouveau pour l'API Colissimo

Thu, 13 Oct 2011 15:11:08 GMT

Il y a quelques mois, je vous avais r�dig� un petit article sur l'API � cach�e � de Colissimo. Or cette derni�re s'est tr�s vite retrouv�e non fonctionnelle, La Poste ayant d�clar� qu'une API � publique � �tait pr�vue. Sauf que constat 8 mois plus tard : toujours rien. J'avais un peu oubli� cette histoire jusqu'� hier je fl�nais dans les commentaires de l'article en question. J'ai alors voulu rev�rifier les dump TCP de l'application de la poste pour m'apercevoir qu'ils n'avaient absolument pas chang�s, et pourtant, l'application marchait ! La seule diff�rence entre les appels effectu�s par l'application mobile et mon script PHP �tait... l'User Agent ! Et en effet, la solution au probl�me �tait bien l�. En for�ant un User Agent de smartphone lors de l'appel PHP, on r�cup�re le r�sultat escompt� ! :) J'ai donc mis � jour la mini-lib pour manipuler l'API. Celle-ci est toujours disponible sur GitHub. Petit changement cela dit lorsque vous voulez r�cup�rer les informations sous forme d'image, il faut d�sormais un dossier local pour stocker les images en question (voir le README dans les sources). PS : merci � @sp0z pour le code de test :)

Configurer son serveur pour la lecture audio / vid�o en HTML5

Thu, 29 Sep 2011 08:31:16 GMT

Si des vid�os h�berg�es sur votre serveur ne s'affichent pas quand vous utilisez la balise <video>, c'est sans doute que votre serveur est mal configur� ! En effet, si votre serveur web ne fournit pas le bon header Content-Type, le navigateur ne saura pas qu'il a � faire � un fichier lisible directement avec les balises HTML5. Pour �tre s�r que les MIME types sont bons, il suffit d'ajouter ces quelques lignes dans votre fichier .htaccess :

AddType audio/webm weba
AddType video/webm webm
AddType video/ogg ogm
AddType video/ogg ogv
AddType video/ogg ogg

[PHP] Utiliser les sessions juste avant un appel � header('Location: ...')

Thu, 07 Apr 2011 14:48:44 GMT

Si vous avez d�j� eu � faire � ce cas de figure, o� vous devez d�finir une variable de session juste avant un appel � la fonction header() pour changer de page (header('Location: ...');), alors vous avez sans doute remarqu� qu'une fois arriv� sur la page, vous n'avez plus aucune trace de votre variable de session ! Pour palier � ce petit probl�me, il suffit de rajouter � votre URL l'id de la session gr�ce � la constante SID, comme suit :

L'API � cach�e � de Colissimo

Tue, 22 Feb 2011 15:23:13 GMT

Mise � jour du 13 octobre 2011 : le script est de nouveau fonctionnel ! C'est par ici que �a se passe : Du nouveau pour l'API Colissimo

Mise � jour du 25 f�vrier 2011 : la Poste m'a contact� sur Twitter (ici et l�) pour m'indiquer que l'API �tait r�serv� � la Poste et ses partenaires, et aussi pour me dire que celle-ci fonctionnait toujours, mais que mon IP avait d� �tre bloqu�e pour activit� anormale. ;-) Vous pouvez donc toujours l'utiliser, mais sans en abuser, et � bon escient. P.S.: Je me d�charge totalement de l'utilisation que vous en ferez.

Mise � jour du 24 f�vrier 2011 : La Poste n'aura pas mis longtemps � r�agir, l'acc�s � l'API vient d'�tre coup�, on obtient d�sormais un joli The requested page has been removed. ~~On peut sans doute s'attendre � une mise � jour prochaine de leur application mobile, vu que du coup, ils l'ont fait planter comme il faut :~~

Mise � jour du 23 f�vrier 2011 : J'ai cr�� une petite lib PHP pour se servir de l'API plus simplement. Celle-ci est disponible sur GitHub.

Un ami est venu me voir r�cemment pour me poser une question par rapport � l'API Twitter. Il cherchait aussi un moyen de r�cup�rer les r�sultat d'une recherche de suivi Colissimo, mais ne trouvant pas d'API et les r�sultats �tant sous forme d'images et non de textes (la poste ne doit pas conna�tre la notion d'accessibilit�), il voulait se diriger vers un syst�me OCR, ce qui aurait �t� un peu casse-t�te et pas garanti � 100%. Cependant, il existe une application Android faite par la poste remplissant le m�me r�le que le site web. Ni une, ni deux, un petit TCP dump en utilisant l'application nous d�voile des choses int�ressantes ! En effet, on peut notamment observer ce genre de choses :

GET /outilsuivi/web/suiviInterMetiers.php?key=d112dc5c716d443af02b13bf708f73985e7ee943&method=xml&code=8L12345678912 HTTP/1.1
User-Agent: Dalvik/1.4.0 (Linux; U; Android 2.3.2; Desire HD Build/FRG83D)
Host: www.laposte.fr

Apr�s quelques tests, on peut donc se rendre compte des possibilit�s offertes par cette d�couverte. URL � appeler : http://www.laposte.fr/outilsuivi/web/suiviInterMetiers.php Param�tres GET :

Nom	Valeur(s)
key	d112dc5c716d443af02b13bf708f73985e7ee943 (cette valeur semble toujours fonctionner � l'heure o� j'�cris ces lignes)
method	aucune (le r�sultat sera une image) xml json
code	Le code de suivi de colis

Par exemple, avec l'URL extraite du dump TCP, on obtient le XML suivant :

Version JSON :

{
  "status":true,
  "code":"8L84527382672",
  "client":"Particulier",
  "date":"07\\/02\\/2011",
  "message":"Votre colis a \\u00e9t\\u00e9 remis au gardien",
  "gamme":"4",
  "base_label":"Coliposte",
  "link":"http:\\/\\/www.coliposte.net\\/particulier\\/suivi_particulier.jsp?colispart=8L84527382672",
  "error":null
}

Ou sous forme d'image :

A vous d�sormais de vous servir de ces maigres informations comme bon vous semble. ;-)tr