Suite à la mise à jour de nos Freebox Révolution survenue il y a quelques semaines, je vous propose aujourd’hui une mise à jour de la classe PHP que je vous avais proposé peu avant le passage sous Freebox OS vous pouvez retrouver mon article ici et qui vous permettait de faire communiquer vos box domotique et internet. La mise à jour proposée par les développeurs de chez Free, en plus d’amener une nouvelle interface graphique, des applis Androïd et Apple ainsi que de nouvelles fonctionnalités, intègre l’ajout d’un serveur REST API permettant de développer sa propre application s’interfaçant avec sa Freebox. La création de cette API officielle va rendre obsolète le script PHP que je vous avais proposé il y a peu. L’API Freebox OS Ce qu’il faut savoir tout d’abord, c’est qu’une documentation officielle pour développeurs est disponible ici pour pouvoir dialoguer avec la Freebox facilitant ainsi les développements locaux. Cette API rend disponibles de nombreuses actions / informations du boitier Server et cela en par fonctions classées en différents groupes Téléchargements, Système de fichiers, Air Media, RRD, Appels / Contacts, Configuration, Stockage, Filtre parental, etc… Elle fait aussi appel à une authentification différente. En effet, il n’est plus nécessaire de renseigner son mot de passe Freebox pour pouvoir utiliser l’application. Il vous faudra l’autoriser directement depuis la face avant de votre Server, en cliquant sur la flèche droite = Oui lorsque le message s’affichera. NB par défaut, l’accès aux parties Configuration et Contrôle parental de l’API n’est pas autorisé. Il faudra les aussi les valider via -> Paramètres de la Freebox -> Gestion des accès. Enfin, l’authentification se fait via un système de jetons tokens. Si l’authentification ne fonctionne plus, je vous invite à supprimer le fichier token » qui a été créé dans le même dossier que les fichiers de la classe PHP et de retenter une authentification. La classe PHP Freebox Cette classe PHP téléchargeable ici permet d’accéder à tout ce que propose l’API Freebox OS. Chaque groupe de l’API Freebox OS est traité dans une sous-classe PHP dédiée. Ainsi, pour avoir accès aux fonctions de la partie Configuration » de l’API Freebox OS, on fera appel on va voir comment un peu plus bas à la sous-classe Configuration » stockée dans le fichier Configuration » du dossier API. Afin de faciliter le développement PHP, j’ai repris les mêmes noms de fonctions de l’API Freebox OS. Ainsi, pour connaitre l’état de la connexion Internet, on va utiliser la fonction Get the current Connection Status » de l’API Freebox OS, fonction du groupe Configuration. En PHP, on fera alors appel à la fonction GetConnnectionStatus » de la classe PHP Configuration ». Dans la classe PHP que je vous propose, vous retrouvez, en plus des fichiers de classe, un fichier qui reprend les mêmes exemples que lors de mon précédent article. Seuls les chemins Xpath ont été amenés à changer. Ainsi, pour accéder à l’état de sa connexion internet, le chemin Xpath sera désormais /freeboxOS/Configuration/GetConnnectionStatus/state Pour connaitre l’espace disque disponible, il vous faudra patienter quelques jours le temps que j’inclue le module Storage » de l’API Freebox OS dans cette classe PHP. Toutefois, dès aujourd’hui, il vous est possible de consulter la liste des appels entrants, sortants, manqués. Le chemin Xpath sera pour le dernier appel /freeboxOS/Calls_Contacts/GetCallsList/id-0 Pour lancer une commande sur la Freebox, rien de plus facile, il vous suffit de reprendre les mêmes commandes que précédemment, légèrement modifiées Eteindre la carte wifi https//IP/ Allumer la carte wifi https//IP/ Rebooter la box https//IP/ Rebooter la box après XX secondes https//IP/ -> Cette commande n’est plus disponible Régler la luminosité de l’afficheur LCD à XX% https//IP/ Je vous invite à jeter un coup d’oeil dans le code PHP du fichier pour avoir la liste de toutes les commandes actuellement disponibles, et dans la documentation de l’API Freebox pour toutes celles nouvellement possibles. Pour les développeurs, ne travaillez que sur un seul fichier PHP, sinon il y aura autant de demandes d’accès à l’API et donc d’appli différentes vu de la Freebox que de fichier différents que vous appelez. Tutoriaux à venir Cette API Freebox OS étant plus développée que celle qui était utilisée jusqu’alors, je vais vous proposer au travers de quelques articles à paraitre ces prochains jours, des petits tutoriels très simples pour exploiter à fond cette nouvelle classe PHP.