Choses à faire

24h dans une journée, et tant de choses à faire !

Une API minimaliste pour la Freebox Revolution

publié le 3 mai 2012 par Pierre Quillery

Bonjour à tous, aujourd’hui je vous propose de nous arrêter un moment sur la Freebox Revolution, dernière née des box internet de Free ; on ne la présente plus ! Plus précisément, je me propose de vous montrer à travers une classe PHP minimaliste comment il vous est possible d’interagir avec elle. En effet, une fonctionnalité d’API a été implémentée par Free puis masquée au lancement de la box

L’hypothèse la plus vraisemblable pour expliquer ce masquage est qu’il n’aient pas souhaité devoir maintenir un support utilisateur pour cette API. Des petits malins ont cependant récupéré la documentation qui est toujours consultable sur votre Freebox, voyez plutôt ici pour vous faire une idée des possibilités offertes par cette API. Une vue de la Freebox Revolution

Techniquement, il n’y a là rien de formidable : il s’agit d’une API JSON/RPC classique avec une petite spécificité, car elle repose l’usage d’un cookie contenant un identifiant de session. Il sera nécessaire d’envoyer ce cookie dans l’en-tête de chaque requête que vous ferez après votre connexion ; mais par chance, ma classe s’occupe de cela pour vous ;).

La première chose que vous aurez vraisemblablement besoin de faire est d’activer l’accès à distance de votre Freebox, si vous voulez vous connecter à l’extérieur de votre réseau local. Cela étant fait, rien ne vous empêche d’utiliser un nom de domaine pour pointer sur votre IP fixe et obtenir ainsi une adresse facile à retenir. Il vous faudra également définir un mot de passe qui sera utilisé lors de la connexion pour obtenir le cookie de session.

Assez parlé, voilà donc le code de la classe FreeboxClient ! Et si d’aventure vous développez quelque chose avec, n’hésitez pas à vous en ouvrir dans les commentaires de cet article :) !

Les textes, illustrations et démonstrations présents sur ce site sont la propriété de leurs auteurs respectifs, sauf mention contraire (photo de la bannière).
Chosesafaire.fr, un site propulsé par Wordpress, vous est proposé par Pierre Quillery & Killian Ebel.

Valid XHTML 1.0 Strict