Freebox Server (Pop V8/ Delta V7 / Revolution V6 / Server Mini 4K)

Suite au bug : External Linkhttps://dev.freebox.fr/bugs/task/21461

Il apparaît que depuis la version 4 des API, certains appels nécessitent vraiment le header

Content-type: application/json

pour fonctionner correctement.

En effet, ce header est bien mentionné (71 fois) pour les réponses, mais jamais clairement pour les requêtes (juste 1 fois pour expliquer qu’il ne faut PAS l’envoyer dans un cas précis).

Cela n’est indiqué nulle part en clair dans la documentation.

Je suggère donc (améliorations) que la documentation mentionne cette “bonne pratique” (puisque en réalité 99% des API fonctionnent néanmoins, mais ce n’est effectivement pas 100% fiable).

Cela pourrait figurer dans la section d’introduction, en donnant des modèles de ‘curl’ par exemple.

Une documentation plus précise est en effet à même d’aider les futurs développeurs en leur évitant de tomber dans des bugs bizarres comme celui signalé plus haut.

Bonjour,
je n’arrive pas à programmer un enregistrement depuis l’API freebox. La documentation étant incomplète, impossible de deviner quels sont les informations nécessaires, et pourquoi j’ai une erreur internal quand j’essaye d’ajouter un enregistrement :( Serait-il possible de compléter la doc, avec notamment un exemple d’utilisation ?
Merci d’avance

Bonjour ,
de récurrents soucis de coupure de courant avec le réseau public de distribution de l’électricité m’ont incité à acquérir un ups pour protéger ma petite installation , et j’ai l’impression que ce type de problème est amené à se multiplié dans le futur .
Donc voila la question à peut être déjà été posée et je n’ai peut être pas cherché assez et par ailleurs je comprendrai que des contraintes techniques l’imposent ou rendent la chose impossible , mais après avoir cherché un minimum je n’ai pas trouvé de possibilité de faire un shutdown du freeboxserver , j’utilise apscupsd sur mes machines et je demande pas l’implémentation d’un client mais j’ai observé que l’api permettait le reboot (via POST /api/v4/system/reboot/) et me demande si le shutdown ne serait pas possible , en effet en cas de coupure si je souhaite continuer à alimenter la box pour maintenir le téléphone en cas d’urgence , j’aimerai aussi pourvoir l’éteindre et privilégier une autre machine à partir d’un certain temps / pourcentage de batterie .
Cette demande n’est ni urgente ni critique , mais je souhaitait avoir votre réponse avant d’envisager l’achat d’un autre ups uniquement pour la freebox ;)

Merci d’avance,
Cordialement

Bonjour,

avec les nouvelles fonctionalités de la Freebox Delta, il serait préférable de pouvoir integrer la domotique (Somfy, ...) avec des applications tierces en fournissant un API

Merci

Bonjour

Ou puis je avoir accès à l’api de là box pour pouvoir contrôler la centrale d’alarme et les détecteur et capteur et télécommande sur ma box lifedomus de delta dore. Il nous manque des infos pour pouvoir l’integrer.

En attente de votre réponse

Je souhaiterai récupérer la totalité des appels émis ou reçus sur ma Freebox. J’utilise donc l’API via cette URL :

/api/v4/call/log/

Seulement 100 éléments me sont affichés mais la numérotation de ceux-ci va bien au-delà (+ de 3000 dans mon cas). Si tous les appels sont gardés en mémoire, est-ce possible de mettre un paramètre optionnel pour récupérer l’ensemble des éléments ?

Bonjour,

J’utilise les APIs du serveur de la freebox et j’ai identifié qu’il existait une API de récupération des sessions (c-a-d une liste des sessions des applications tierces connectées aux API). Cette API correspond à “Gestion des accès > Sessions” dans l’interface web accessible depuis mafreebox.freebox.fr.

L’API semble être accessible depuis l’url http://mafreebox.freebox.fr/api/v6/sessions mais lorsque je l’appelle avec ma propre application (qui possède son propre app_token préalablement granted), j’ai un code retour 403 (Unauthorized).

Que dois-je faire pour pouvoir accéder à cette API ?

Merci bcp pour votre aide

Bien cordialement,

Jean-Baptiste

Bonjour,

Je viens de changer de freebox server et je n’arrive pas à me connecter à ma box en utilisant l’application smartphone freebox compagnon.
J’ai un message d’erreur : “Erreur
Failed to connect to ...” (adresse IP)

Je ne peux pas choisir ma box.
Je suis bien connecté en WiFi.
Je peux me connecter à ma box freebox OS via internet mais ça ne fonctionne pas via l’application freebox compagnon.
J’ai essayé de désinstaller / réinstaller plusieurs fois.

L’adresse IP indiquée dans le message d’erreur freebox compagnon est différente de l’adresse IP indiqué dans les paramètres de freebox OS.

Bonjour,

Apple demande des CGU ou tout autre texte qui authorise un dev indépendant d’utiliser l’api REST de la freebox. Rien n’est mentionné sur le site.

Quelques lignes disant que l’on peut faire des application IOS + Android avec l’api serait vraiment bien.
Et aussi que l’on peut mentionner le nom “Free” ou “Freebox” tant que ça reste nominatif genre “pour Freebox ...” ce serait vraiment pratique aussi.

J’ai plusieurs applications sur la store et j’ai sans arrêt des soucis vu qu’on ne trouve aucun texte ou CGU.
Désolé si ce n’est pas le bon endroit mais je ne sais pas du tout où poster ça à part sur un truc de dev.

Merci

Bonjour,

Les entêtes HTTP des fichiers proposés par l’API, comme les logos des chaînes, ne sont plus disponibles.
Sauf erreur de ma part, la requête suivante fonctionnait il y a peu :

curl -I http://mafreebox.freebox.fr/api/v8/tv/img/channels/logos68x60/uuid-webtv-201.png

Désormais, elle retourne :

HTTP/1.1 404 Not Found
Server: nginx
Date: Fri, 20 Nov 2020 17:24:52 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive

Ce comportement est aberrant puisque la ressource existe bel et bien.
Ainsi, la requête GET correspondante fonctionne :

curl -I -X GET http://mafreebox.freebox.fr/api/v8/tv/img/channels/logos68x60/uuid-webtv-201.png

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 20 Nov 2020 17:28:02 GMT
Content-Type: image/png; charset=utf-8
Content-Length: 1777
Connection: keep-alive
Last-Modified: Wed, 18 Nov 2020 11:31:39 GMT
ETag: "5fb5061b-6f1"
Expires: Wed, 25 Nov 2020 11:55:21 GMT
Cache-Control: max-age=604800
Accept-Ranges: bytes

Cette régression a vraisemblablement été introduite dans Freebox OS peu avant le 26 août.

Merci :)

n peut trouver la documentation de l'API Freebox ici : https://dev.freebox.fr/sdk/os/ et elle est publique
Cependant, cette documentation ne semble pas à jour et/ou pas complète : c'est dommage

Certe on peut la trouver sur l'aide sur Freebox OS (qui s'appelle maintenant "Développer" dans le menu Free en bas à gauche)
Ou en allant sur l'URL :
http://mafreebox.freebox.fr/doc/index.html#developer-api-documentation

On voit d'ailleurs la grosse différence entre les 2 documentation (publique et maFreebox) sur la partie Api List
Les paragraphes suivants :
- home
- notification
- Players Devices
- Virtual Machines
n'existent pas sur la documentation publique (premier lien)

Est-ce volontaire ?
Pourquoi publier en public qu'une partie de la documentation ?

Bonjour

Suite au passage en 4.5.3 "officiel", la section changes de l'API ne fait pas mention de l'ajout d'une API pour faire une sauvegarde de la box / restorer une sauvegarde.

Pourriez vous SVP ajouter une API permettant d'automatiser les sauvegardes ?
Pourriez vous également ajouter une API permettant de restorer une sauvegarde ?

Pouvoir créer une sauvegarde avec l'API vers un drive de la box ou un serveur réseau serait un plus.
Idem pour la restoration d'une sauvegarde depuis l'API.

En vous remerciant d'avance,
Cordialement
nbanba

Bonjour à tous,

pour info,
après plusieurs essais infructeux dans tous les sens
j'ai enfin réussi à obtenir un session token

la doc API intégrée à la freebox (https://mafreebox.freebox.fr/doc/index.html#)
est erronée concernant le calcul du "password".

ce password est necessaire dans la requête du session token

—> dans la doc est écrit
—> dans le paragraphe "Obtaining a session_token"/"password string"
—> password = hmac-sha1(app_token, challenge) (←– CECI NE FONCTIONNE PAS)

avec le password ainsi calculé,
j'obtenais en réponse à la requête de session token (POST http)

Status Code: 403 Forbidden
msg: Erreur d'authentification de l'application
error_code: invalid_token

Pour que ça fonctionne,
il faut inverser app_token et challenge dans la formule

(CECI CI-DESSOUS FONCTIONNE)
(variables challenge et app_token préalablement attribuées bien sûr)

#en php
$password = hash_hmac("sha1", $challenge, $app_token); 

#ou en bash
password=$(echo -n $challenge | openssl sha1 -hmac $app_token | cut -d '=' -f2 | sed 's/ //g')

—> et avec le bon password, ça passe mieux
—> session_token (enfin) reçu

en remarques complémentaires (de ce que j'en ai compris),

- l'app_token une fois sollicité/autorisé/validé est pérenne 
- le challenge par contre, à une durée de validité courte (30 secondes), 
  validité courte qui est donc conférée au password. 
  Et donc pour réussir l'obtention du session_token, 
  la requête/obtention du challenge, le calcul du password et la requête du session_token 
  doivent être fait pendant cette période de validité de 30 secondes.
- je suppose que le session_token est relativement pérenne  
  (pas pu tester longtemps) mais on sait maintenant comment en solliciter un autre...

HTH,
cordialement,
hého

Bonjour,

je souhaite développer une application en python pour me connecter à ma freebox POP.

J’ai bien compris que la première étape est d’inscrire son application et de l’autoriser sur la box. Voici mon code:

 headers = {}

  payload=json.dumps ({
 "app_id": "fr.freebox.test",
 "app_name": "test",
 "app_version": "1.0.0",
 "device_name": "NO"
  })

  try:        
      response = requests.request('POST', 'https://mafreebox.freebox.fr/api/v10/login/authorize', headers=headers, data=payload,verify=False)
  except Exception as e:
      print ('Execution Box Authorize commmand failed : ' + str(e))     
  else :
      if (response.status_code == 200) :
          authorize = response.json()
          print (authorize)

Tout fonctionne bien je récupère bien un app_token :

{’success’: True, ‘result’: {’app_token’: ‘xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx’, ‘track_id’: 74}}

Et sur la box s’affiche l’authorisation. Mais j’ai beau essayé de valider en sélectionnant Oui sur l’édcran LCD (Fleche droite puis l’écran affiche de nouveau l’heure), La console des accès reste la même :

—–> ‘Authentification en cours’

Avez-vous une idée de là où ça coince ?

Cordialement

Bonjour

J’ai paramétré deux caméras chez un de mes clients, elles sont en adresse IP fixe en dehors de la plage du DHCP, avec deux redirections de ports pour avoir accès à mes caméras depuis l’extérieur. Tout fonctionné très bien depuis plus d’un an et demi et tout d’un coup depuis quelques semaines, je n’ai plus accès aux caméras depuis l’extérieur.
La seule chose que je vois d’anormale est le fait que je ne peux pas pinger la box depuis l’extérieur. J’ai bien sur prix soin d’activer le ping sur le portail de la box en question.
Et la commande msdos tracert xx.xxx.xx.xx n’abouti pas, le delai d’attente est dépassé ce qui me semble vraiment anormal.

Je n’ai malheureusement pas trouver de réponse à mon problème et mes clients envisage très sérieusement de quitter Free alors qu ej’ai d’autres clients avec le smêmes caméèas configurés de la même manière et tout fonctionne très bien.

J’espère avoir exposé clairement mon problème et j’espère que quelqu’un pourra rapidement m’aider à le résoudre.

Bien cordialement

Bonjour, mon fils réussi à s’associer à la freebox pop sans saisir le mdp administrateur dans Freebox Connect. Le mdp est pourtant assez compliqué, je l’ai changé plusieurs fois et il est enregistré nulle part.

– Titre édité suite aux échanges

A cause d’une latence de plusieurs dizaines de millisecondes dans le traitement du signal audio via la fonction airmedia de la freebox revolution, il est impossible d’utiliser correctement cette fonction de la freebox au sein d’un systeme avec d’autres haut-parleurs fonctionnant également en airplay. En effet le décalage sonore entre les autres appareils et la freebox est trop important.

Ayant un iphone 4, un mac et ma freebox serveur juste à coté de mon ampli audio, j’utilise exclusivement la fonction airplay pour écouter de la musique.

Depuis la dernière mise à jour de la freebox serveur 1.1.3, il est possible de piloter airmédia depuis l’écran ldc.
Ce dernier affiche d’ailleurs les infos sur le morceaux joué lorsque ces dernières sont disponibles ainsi que le niveau sonore.
Mais cette nouveauté ce fait au détriment de l’affichage de l’heure ...

L’ajout de cette fonction gadget (selon moi) pénalise tous ceux qui n’en ont pas l’utilité dans la mesure où il n’existe pas une possibilité de préférer afficher l’heure.

Alors certes je pourrais préférer utiliser le boitier freebox player pour garder l’heure visible, mais cela me contraindrait à laisser mon plasma allumé (la freebox player n’ayant qu’une entrée audio OPTIQUE je ne peux connecter cette dernière à mon ampli qu’au travers de ma TV)

La sortie audio mini jack freebox server (Révolution)lié à airplay ne marche plus depuis la mise à jour 4.3 - 4.3.1

Depuis le début de la pandémie, je suivais des réunions zoom par mon ordinateur portable et utilisais le média Player de Free pour recopier l’image et le son sur ma télé de 65 pouces. Tout fonctionnait très bien avec une belle qualité d’image est un son parfait jusqu’à la dernière mise à jour de la Freebox. Depuis, que je sois en recopie d’écran de téléphone, de tablette, ou de PC portable je n’ai plus de son, seulement l’image.
J’ai en parallèle une Apple TV branché sur mon réseau wi-fi Freebox. Curieusement, avec cet Apple TV la recopie de l’image et du son sur mais téléviseur fonctionne toujours parfaitement. J’ai tenté un Reset de ma Freebox révolution ainsi qu’un Reset du média Player, j’ai également changé le Cable HDMI entre ma Freebox et ma télévision mais rien n’y fait. Le support technique de Free m’a répondu que cette panne est nouvelle et que probablement nous devrions attendre une nouvelle mise à jour dans les mois à venir !

Toute aide me permettant de récupérer à nouveau du son avec l’image en recopie d’écran sera la bienvenue. Merci d’avance, Fabrice.

Pourquoi ne peut on pas demander à Alexa ou a OK Freebox de jouer une musique mp3 qui se trouve sur le nas de la Freebox ?
C’est vraiment dommage !

Les films contenus sur un disque dur, clef ou sur un NAS qui sont en stéréo ne seront pas convertis
il n’est donc pas possible de transformer un simple son Stéréo en Son plus ample ProLogic II sur la Freebox Delta

Bonjour je souhaiterais soumettre une suggestion.

Serait il possible d’avoir une une application qui recherche automatiquement dans le dossier ou disque dur souhaitez de la Freebox les musiques et avoir ainsi une interface musiques plus agréable que la gestion de fichiers de la Freebox (une interface qui pourrait ressembler à ce qu’il ce fait comme sur itunes, deezer, spotify, clémentine ETC)

Je vous remercie d’avance

Lors des partage d’écran AirPlay, le player délire et déforme régulièrement le son des vidéos, (une vidéo sur deux quasiment) c’est lourd quand on veux diffuser des photos et vidéos, obligé en général de redémarrer le player et relancer AirPlay

La sélection du type de Media ‘audio’ sur le freebox server pour diffuser du son par AirPlay à l’aide de l’API AirMedia reztourne une erreur : ‘Not Implemented’.
Le Freebox server devrait pourtant gérer l’auduio (exemple issu de la doc FBOS) :

{

 success: true,
 result: [
    {
       capabilities: {
          photo: true,
          screen: false,
          audio: true,
          video: true
       },
       name: "Freebox Player",
       password_protected: true
    },
    {
       capabilities: {
          photo: false,
          screen: false,
          audio: true,
          video: false
       },
       name: "Freebox Server",
       password_protected: false
    }
 ]

}