Tous les projets

Il serait intéressant de permettre aux dev’s plus d’interaction avec l’utilisateur en permettant par exemple d’afficher des messages sur l’écran du freebox serveur, de déclencher des alertes sonores via les hauts parleurs intégrés ou d’envoyer des bandeaux textes sur l’écran de la TV, voir même de pouvoir incruster une image (équivalent PIP) dans une zone de l’écran, de pouvoir ouvrir une zone de texte à remplir par l’utilisateur à l’aide de la télécommande, de pouvoir faire apparaitre des boutons cliquables à l’écran TV. Toutes ces fonctions étant accessibles via l’API.

j’en demande trop non ?

Bonjour,

La nouvelle API ne permet plus de choisir le nom du fichier que l’on télécharge, il le défini de lui même, contrairement à l’ancienne API qui permettait de choisir un nom de fichier à l’ajout d’un nouveau téléchargement.

Il serait pas mal d’avoir un paramètre “name” facultatif à l’ajout d’un téléchargement par url.

bonjour

serait il possible d ajouter des signaux de status de lecture pour le airmedia sur la freebox, etat lecture/pause/arret voir dans l ideal un signal de fin comme dans gstreamer avec le signal about_to_finish ou finished

merci

cdt

Bonjour,

Serait-il possible de proposer une API Freebox OS pour gérer les enregistrements programmés ?
- lister et interroger les enregistrements programmés,
- créer, modifier, supprimer un enregistrement programmé.

Une Application Freebox OS pourrait aussi être proposée, (mais c’est surtout l’API qui est demandée).

À voir si cette API pourrait aussi donner accès à un Guide des Programmes pour permettre la création d’un nouvel enregistrement, mais cela est peut être en dehors du champ de Freebox OS.

Pour la justification de cette demande, voir http://dev.freebox.fr/bugs/task/13413

Cordialement,

DFAL

Bonsoir,

Serait il possible de gérer, lors des téléchargements, la reconstitution des fichiers nom-de-fichier.0, nom-de-fichier.1, nom-de-fichier.2 ...
lorsque je lance une réparation avec les Par2 qui devrait reconstruire le fichier, cela ne fonctionne pas.

Merci pour votre retour.

Bonne soirée,

J’ai ecrit un plugin pour les lecteurs multimedia Linux (un plugin Grilo) qui exporte les chaines de TV disponible en second poste vers un ordinateur.

Serait-il possible d’exporter aussi les logos de ces chaines pour un meilleure integration?

Actuellement l’API AirMedia du FreeboxOS permet l’affichage de photos et de videos mais pas la lecture de fichiers audio.
Il est possible de choisir le media_type “video” et de renseigner l’url d’un fichier audio mais on se retrouve avec un écran noir sur la TV.

L’idéal serait de reproduire ce qui est proposé pour AirPlay :
- affichage du titre (cover, titre, etc) dans l’application AirMedia
- affichage de la notification (en haut à droite) à la lecture du fichier audio

Avec possibilité de renseigner les informations du media : cover, titre, artiste, etc; si celles-ci ne sont pas disponible dans le fichier. Ou même rendre ces infos obligatoires.

Bonjour,

Depuis une adresse externe au reseau local :
GET /api/v3/login/session/ HTTP/1.1

Renvoie HTTP 200 mais avec success false et error_code denied_from_external_ip.
Pour être cohérent avec le reste de l’API et conformément a la documention il faudrait renvoyer un HTTP 403 dans ce cas là.

En attendant je vais mettre un if 200 and success == true dans mon code ...

Bien a vous !

Bonjour,

Serait il possible de mettre en place une procédure de réinitialisation du mot de passe Server par envoi d’un code par sms ou email à la place (ou en doublon ?) du code affiché sur le panneau du Server ?

Motivation :
- sécurisation de la procédure (voir par exemple  FS#17543 ),
- panneau d’affichage Server illisible (mon cas),
- intervention à distance.

Pour cela il faudrait :
- une évolution au niveau Freebox OS (ou page Web d’administration sur le site Free) pour pouvoir enregistrer un numéro de téléphone portable pour l’envoi du sms ou une adresse mail pour l’envoi d’un mail, et une option pour choisir le mode de gestion du code de réinitialisation du mot de passe (affiché sur le Server, envoyé par sms, envoyé par mail, ou plusieurs de ces options en même temps),
- une API Freebox OS pour pouvoir activer la procédure de réinitialisation à distance,
- l’implémentation dans les Compagnons (Android, iOS) de l’appel à cette API.

Cette procédure devrait aussi être utilisable pour une connexion à Freebox OS via un navigateur WEB.

Le code envoyé par sms ou mail devra avoir une durée de validité suffisamment longue pour permettre sa réception et sa ressaisie dans l’interface de réinitialisation du mot de passe.

Cordialement,

DFAL

Bonjour,

Avec la version 3.3, il est possible de gérer une liste de noms de domaines auxquels la Freebox répond depuis l’extérieur, et d’y ajouter des certificats SSL.

Serait-il possible d’étendre l’API pour permettre de configurer ces noms de domaines et leurs certificats ?

Ceci permettrait par exemple d’écrire un plugin pour le client letsencrypt qui permettrait de gérer le renouvellement automatisé (avec un client letsencrypt qui tourne sur un PC) du certificat SSL pour les noms de domaine personnalisés, et son installation automatique sur la Freebox.

Merci.

Il est indiqué dans la documentation que les champs dsl::rate_up et dsl::rate_down sont renvoyés en octet/s (byte/s), alors qu’ils sont renvoyés en bits/s.

De même il est indiqué que les champs net::rate_up et net::rate_down sont renvoyés en octet/s (byte/s) alors qu’il sont renvoyés en koctets/s.

Il faudrait corriger la documentation ou l’API.

L’accès aux variables RRD nécessite une autorisation supplémentaire de “Modifications des réglages de la Freebox”, alors qu’ils sont en lecture seule, et que rien ne l’indique dans la documentation.

Dans le cadre du développement d’un plugin pour Rainmeter (https://github.com/Kitof/RainFbx), je dois demander aux utilisateurs d’activer cette autorisation ce qui est de manière à les inquiéter sans raison particulière.

Bonjour,
En me basant sur le sdk (http://dev.freebox.fr/sdk/os/login/#make-an-authenticated-call-to-the-api) je n’arrive pas à m’authentifier .
J’interroge la freebox en PHP avec php-curl.

POST /api/v3/login/authorize/ me retourne HTTP/1.1 200 OK - {”msg”:”Requête invalide (404)”,”success”:false,”error_code”:”invalid_request”}bool(true)

L’erreur vient de la documentation.

Merci

Quand il y a plus de 256 numéros de téléphone, à la création du numéro de téléphone, l’id retourné est modulo 256. Il n’est plus possible ensuite d’accéder à ce numéro par l’API. La supression du numéro par l’interface web Freebox Os est également impossible.

Exemple :

is_own: 'False'
number: '1234567890'
contact_id: '150'
is_default: 'False'
type: 'fixed'
id: '684'

DELETE /number/684 ->
 {'status': 200, 'cookies': <RequestsCookieJar[]>, 'content_type': 'application/json; charset=utf-8', 'is_json': True, 'timeout': False, 'data': {u'msg': u'Impossible supprimer cet objet', u'error_code': u'internal_error', u'success': False}}

Example request:

PUT /api/v3/contact/addtogroup/ HTTP/1.1
Host: mafreebox.freebox.fr
{
  "group_id": 2,
  "contact_id": 6
}

Example response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
    "success": true
}

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

Pas de doc pour la version 6.0 des api freebox

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,
serait-il possible d’avoir de la documentation et des exemples sur la partie domotique et l’alarme en particulier.

J’ai bien vu la partie “Special Tiles specification” dans la documentation sur la Freebox mais je n’ai pas trouvé comment, par exemple, activer ou désactiver l’alarme.

Merci

Bonjour,

En écoute de playlist sur Qobuzz celle-ci , arrête de jouer la playlist.
Pour la relancer il faut recliquer sur le morceau en cour pour que la lecture reprenne.

Merci

Bonjour,

j’explore actuellement l’utilisation des api freebox, je constate que la doc n’est pas à jours, il y est fait mention de la v5 des api, quand je fait une requete mDNS je constate que les api sont en fait en V7.

Il est fait mention de websocket dans cette doc, il n’est pas fait mention de l’url pour les utiliser, et de fait j’ai essayer tout ce qu’il me passait par la tête et rien n’a fonctionner.

Ma demande consiste donc a avoir la doc à jour, et dans l’intervalle je ne serais pas contre un p’tit exemple d’utilisation des websockets ou au moins l’url du endpoint.

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 :)