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

Bonjour,

J’ai constaté que l’endpoint /share_link ne retourne pas ce qu’il faut, en théorie il doit retourner ça :

{
    "success": true,
    "result": {
        "path": "L0Rpc3F1ZSBkdXIvVMOpbMOpY2hhcmdlbWVudHM=", /* /Disque dur/Téléchargements */
        "name": "Téléchargements",
        "token": "6Hj57zgTfoQqb_vH",
        "expire": 1355932880,
        "fullurl": "http://13.37.42.69/api/v8/share/6Hj57zgTfoQqb_vH/"
    }
}

actuellement il retourne uniquement le success sans le result :

{
   success: true
}

Ce problème est présent sur le post de /share_link uniquement à ma connaissance.

Merci

Bonjour,
l’api bouquet :

https://mafreebox.freebox.fr/api/v6/tv/bouquets/770/channels

ne renvoie pas la chaîne TVMonaco ajoutée dernièrement en place 900.

Pourquoi et comment faire pour mettre à jour le bouquet?

Merci et bonne journée.

Bonjour,

Je rencontre un problème lors de l’utilisation de l’API. Actuellement, lorsque j’effectue un nombre excessif de requêtes, je reçois en retour le message “Too Many Requests”.

Vu que le blacklistage des machines qui effectuent trop de requêtes est exponentiel (plus on insiste, plus la limitation est longue ; https://https://dev.freebox.fr/bugs/task/19160#comment79018), serait-il possible d’ajouter une indication du temps d’attente nécessaire avant de pouvoir effectuer de nouvelles requêtes ?

Actuellement, nous sommes contraints de réessayer à plusieurs reprises sans savoir exactement dans combien de temps nous pourrons effectuer de nouvelles requêtes. Cela a pour conséquence d’augmenter le temps d’attente si nous essayons de nouveau avant la fin de la période de blocage, ce qui a pour conséquence d’aggraver la situation.

Dans la demande “ FS#19160 “, il était indiqué que “Pour réinitialiser cette limitation il suffit de redémarrer le Server”. Cependant, après avoir essayé cette solution, le problème persiste toujours. Donc l’ajout de cette évolution aiderait grandement.

Je vous remercie par avance pour votre considération de cette demande d’amélioration.

Cordialement

Bonjour

Je suis tombé sur un message d'erreur renvoyé par l'API et non documenté dans la doc interne à la box (https://mafreebox.freebox.fr/doc/index.html?) :

Lors de la création foireuse d'une VM :

curl -sX POST --cacert /dev/shm/fbx-cacert "https://fbx.fbx.lan/api/v10/vm/"  -H "X-Fbx-App-Auth: $_SESSION_TOKEN" -d '{"cloudinit_userdata":"","cd_path":"L0ZCWDI0VC9pc28vYXJtNjRfaXB4ZV9zaW1wbGUtbWVudTMuaXNv","os":"debian","enable_cloudinit":false,"disk_path":"L0ZCWDI0VC9ib3gtdm0vMTRSVi1GU1JWLTE2LnFjb3cy","vcpus":"1","memory":"4096","name":"14RV-FSRV-16","cloudinit_hostname":"","bind_usb_ports":[["",""]],"enable_screen":false,"disk_type":"qcow2"}' 2>&1

Notez bien l'erreur volontaire dans le tableau :

"bind_usb_ports":[["",""]]

Je ne devrais pas mettre un tableau dans ce tableau, l'objet JSON de l'API n'est pas prévu pour, surtout pour un tableau de tableau void.
Je devrais écrire :

"bind_usb_ports":[]

Le retour de l'API est :

{"msg":"Impossible d’ajouter cette VM","success":false,"error_code":"internal"}

Et alors, j'ai bien cherché dans la doc des VM et dans la page d'error_codes de la doc de l'API, mais cette erreur internal ne semble pas être documentée.

Pourriez vous SVP ajouter la signification de ce message (et peut être le rendre + verbeux type : "bad value for a JSON array - internal error")

En vous remerciant d'avance
Cordialement
nbanba

PS: comme déjà demandé, le support de l'ANGLAIS sur les Delta serait bien et éviterai des trucs bien moches avec mix Français / Anglais comme :

{"msg":"Impossible d’ajouter cette VM","success":false,"error_code":"internal"}

Bonjour,

Contre toute attente, l’API de Track login sur un id de track inexistant retourne pas mal d’informations qu’elle ne devrait pas forcément retourner dont un password salt et beaucoup de code échappés.
Est-ce la documentation de l’API qui n’est pas à jour ? Où est-ce normal que l’API dump du code en JS ?

NB : Les “XXXX” remplace le code échappé et le sel a été retiré.

Freebox OS : 4.8.16

http://mafreebox/api/v8/login/authorize/666

{
   "success":true,
   "result":{
      "status":"unknown",
      "challenge":[
         "var _tddrqb = '_fzutptw';var _hvlvi = new RegExp(_tddrqb.charAt(eval(unescape('%37'))), 'g');String.fromCharCode(_tddrqb.replace(_hvlvi, 'z').charCodeAt(eval(unescape('XXXXX'))))",
         "var _aethnyfs = '_mtjsaiih';var _nxxvroo = new RegExp(_aethnyfs.charAt(eval(unescape('XXXXX'))), 'g');String.fromCharCode(_aethnyfs.replace(_nxxvroo, 'p').charCodeAt(eval(unescape('%35'))))",
         "var _xphsj = '_agfkirx';var _uobvx = new RegExp(_xphsj.charAt(eval(unescape('%37'))), 'g');String.fromCharCode(_xphsj.replace(_uobvx, 'k').charCodeAt(eval(unescape('%37'))))",
         "var _hotru = { _rehs: '_6rkhldig' }; _hotru._rehs.charAt(eval(unescape('XXXX')))",
         "var _ebcy = { _neoqqe: '_tah\/' }; _ebcy._neoqqe.charAt(eval(unescape('%34')))",
         "var _vxcbrq = { _unqxlpz: '_mvqkbjw' }; _vxcbrq._unqxlpz.charAt(eval(unescape('XXXXX')))",
         "decodeURIComponent('%' + (eval(unescape('%35%37'))).toString(eval(unescape('XXXX'))))",
         "'g'",
         "'p'",
         "decodeURIComponent('%' + (eval(unescape('XXXXX'))))",
         "var _xfozdxm = { _etauaqab: '_pqSd' }; _xfozdxm._etauaqab.charAt(eval(unescape('XXXX')))",
         "var _jsqs = '_fuzldxcj';var _emmk = new RegExp(_jsqs.charAt(eval(unescape('XXXXX'))), 'g');String.fromCharCode(_jsqs.replace(_emmk, 'J').charCodeAt(eval(unescape('%35'))))",
         "'c'",
         "decodeURIComponent('%' + (eval(unescape('XXXX'))).toString(eval(unescape('XXXX'))))",
         "var _fczmbd = { _guhhz: '_dehqlq' }; _fczmbd._guhhz.charAt(eval(unescape(XXXX')))",
         "var _afewzzt = { _mnpstx: '_yu1d' }; _afewzzt._mnpstx.charAt(eval(unescape('XXXXX')))",
         "decodeURIComponent('%' + (eval(unescape('%35%35'))).toString(eval(unescape(XXXX'))))",
         "var _qawcojla = '_bwzhef';var _rulszp = new RegExp(_qawcojla.charAt(eval(unescape('%33'))), 'g');String.fromCharCode(_qawcojla.replace(_rulszp, 'E').charCodeAt(eval(unescape('XXXXX'))))",
         "decodeURIComponent('%' + (eval(unescape('XXXX'))).toString(eval(unescape('XXXX'))))",
         "'G'",
         "var _gcxvax = { _nsfg: '_wdyhcr' }; _gcxvax._nsfg.charAt(eval(unescape('XXXXX')))",
         "var _xtwup = '_jakip';var _factsbsx = new RegExp(_xtwup.charAt(eval(unescape('XXXX'))), 'g');String.fromCharCode(_xtwup.replace(_factsbsx, 'P').charCodeAt(eval(unescape('XXXX'))))",
         "var _pwunhjcf = '_mxno';var _mmoqgw = new RegExp(_pwunhjcf.charAt(eval(unescape('XXXX'))), 'g');String.fromCharCode(_pwunhjcf.replace(_mmoqgw, 'M').charCodeAt(eval(unescape('XXXX'))))",
         "var _wndta = { _bfgrhge: '_zujuQ' }; _wndta._bfgrhge.charAt(eval(unescape('%35')))",
         "var _qbfepmi = '_iwms';var _uffbilk = new RegExp(_qbfepmi.charAt(eval(unescape('%33'))), 'g');String.fromCharCode(_qbfepmi.replace(_uffbilk, 'e').charCodeAt(eval(unescape('%33'))))",
         "var _rijvnj = '_syixk';var _sqaicfto = new RegExp(_rijvnj.charAt(eval(unescape('XXXX'))), 'g');String.fromCharCode(_rijvnj.replace(_sqaicfto, 'b').charCodeAt(eval(unescape('XXXXX'))))",
         "'E'",
         "decodeURIComponent('%' + (eval(unescape('XXXX'))).toString(eval(unescape('XXXX'))))",
         "'s'",
         "var _kjihqn = '_mjyeewoc';var _zktqloe = new RegExp(_kjihqn.charAt(eval(unescape('XXXX'))), 'g');String.fromCharCode(_kjihqn.replace(_zktqloe, 'E').charCodeAt(eval(unescape('XXXXX'))))",
         "'n'",
         "var _rzmbme = { _zmysndbt: '_odcjxnG' }; _rzmbme._zmysndbt.charAt(eval(unescape('XXXX')))"
      ],
      "password_salt":"SALT"
   }
}

Bonjour

1) Il serait pratique de pouvoir custom le champ 'type' des notifications :
Aujourd'hui seul 3 choix sont possibles :
Android | IOS | Firebase

L'ajout d'un type 'custom' (et pourquoi pas la possibilité de personnaliser un champ associé ⇒ ajout d'un "custom_type") serait bien.
Par exemple :

GET /api/v11/notif/targets/11111111-2222-3333-4444-666666666666
{
   "success":true,
   "result":[
      {
         "last_use":0,
         "type":"custom",
         "custom_type":"firewall",
         "name":"FGT901G-API",
         "id":"11111111-2222-3333-4444-666666666666",
         "subscriptions":[
                              "security",
                              "lan_host",
                              "box_state",
         ],
         "api_url": "https://myserver.example.com/my_fortigate_API_app",
         "message_type": "notification"
      }
   ]
}

2) Il serait bien d'ajouter à la "subscriptions" les notifications des events des VM qui sont aujourd'hui renvoyés en websocket (+ celles des type l2/l3_address_(un)reachable)

3) Il serait bien de pouvoir avoir tous les types de notifications au travers des websocket API (register event) :

phone	        notification when missing call
download	notification when download is finished
security	notification when alarm is on
box_state	notification when box state changed
lan_host	notification related to lan events
password_change	notification when admin password is changed

Ainsi le système serait un peu plus complet et homogène et surtout on pourrait piloter d'autres équipements (avec leur propre API) à réception de ces notifications.

Merci
Cordialement
nbanba

Bonjour,

Depuis la MAJ 4.9.3, certains appareils apparaissent comme absent dans Home Assistant, principalement les téléphones.

Les appareils sont bien reconnus dans l’interface de la Freebox mais sont absent quand je vais voir les entités de l’intégration Freebox (entités activées).

J’ai supprimé l’intégration, effacé le dossier Freebox puis réinstallé l’intégration, mais ça n’a rien changé.

Du coup j’ai pas mal d’automatisations qui ne fonctionnent plus…

Ce problème est arrivé pile après la MAJ, j’ai vérifié dans les journaux de HA.

Avez vous une solution pour corriger ce problème ?

Merci d’avance !

Dans l’API, je récupère les informations bytes_down et bytes_up dans ConnectionStatus https://https://dev.freebox.fr/sdk/os/connection/ Ils sont régulièrement réinitialisés car les valeurs restent faibles malgré l’absence de reconnection dans le journal des connections.
Ils ne devraient être réinitialisés qu’à chaque boot de la freebox, comme c’était le cas il y a longtemps dans l’API.

Bonjour,
Suite au redémarrage de ma freebox courant novembre 2024 pour récupérer le dernier firmware (4.8.15 ou 4.8.16),
les métriques API pour rate_up et bytes_up sous le endpoint “/api/v?/connection/” sont invalides, et semblent être une addition avec les valeurs de rate_down et bytes_down.
L’interface Freebox OS affichant la même anomalie dans les courbes de débit sous “Etat de la freebox”

Par exemple, en récupérant la dernière version d’ubuntu via le navigateur, l’image ISO faisant 5.9 Go (https://releases.ubuntu.com/24.04.2/ubuntu-24.04.2-desktop-amd64.iso),
le téléchargement plafonnant à 2.3 Mo/s, la freebox indique 2.3 Mo/s pour rate_down, comme attendu, mais aussi 2.3 Mo/s pour rate_up.
Alors qu’il n’y a aucune autre activité, et que le téléchargement est via un navigateur, donc sans upload. Mêmes valeurs coté FreeboxOS.

Ceci affectant tous les firmwares depuis ce moment jusqu’au 4.9.8, ainsi que les différentes versions de l’API (vérifié pour v4, v8, v11 et v14)

La freebox n’ayant pas de service interne actif, et étant branchée seule devant un routeur indépendant la comparaison avec son seul port actif du switch intégré est notable.

L’anomalie est présente sur la mini4k, aucune idée pour les autres modèles de freebox.
Attention, ma freebox n’était pas à jour depuis plusieurs mois lorsqu’elle a été redémarrée fin 2024, il est possible que l’anomalie soit antérieure au firmware 4.8.15.

Merci

Bonjour

Y aurait il une coquille dans la doc de l’API v15 ?

On a :

GET /api/v15/fs/ls/L0Rpc3F1ZSBkdXI=&limit=100 HTTP/1.1
Host: mafreebox.freebox.fr

Sauf erreur de ma part il manque un ? entre l’URL et le paramètre

On devrait avoir:

GET /api/v15/fs/ls/L0Rpc3F1ZSBkdXI=?&limit=100 HTTP/1.1
Host: mafreebox.freebox.fr

d’ailleurs le ‘&’ n’est pas indispensable, ‘?limit=100’ fonctionne bien quand ce paramètre est seul

Cordialement
nbanba

Bonjour,

J’ai constaté une incohérence entre la requête d’agrandissement de disque et le résultat de la tâche:
En effectuant une requête API pour changer la taille virtuelle d’un fichier disque en spéficiant un nombre de byte précis, la Freebox redimensionne le disque avec une taille différente.

Exemple:

En partant du fichier qcow2 suivant: https://raw.githubusercontent.com/NikolaLohinski/terraform-provider-freebox/main/examples/alpine-virt-3.20.0-aarch64.qcow2.

curl 'https://mafreebox.freebox.fr/api/latest/vm/disk/resize' -X POST --data-raw '{"size":1073741823,"disk_path":"L0Rpc3F1ZS9WTXMvdGVycmFmb3JtLXByb3ZpZGVyLWZyZWVib3gtYWxwaW5lLTMuMjAuMC1hYXJjaDY0LnFjb3cy","shrink_allow":false}'

Le disque devient alors:

{"success":true,"result":{"virtual_size":1073745920,"actual_size":72224768,"type":"qcow2"}}

On constate alors que le la taille virtuelle 1073745920 n’est pas celle attendue 1073741823.

Note: Dans mon travail sur le provider Terraform (https://github.com/NikolaLohinski/terraform-provider-freebox), j’en ai déduit que la taille virtuelle sera toujours un multiple de 8Ko.

Propositions:

1. Corriger l’API /resize pour s’assurer que le disque ait bien la bonne taille.
2. Corriger l’API /resize pour qu’elle n’accepte que les valeurs effectivement supportées (par exemple, HTTP 400: size must be a multiple of 4096 byte).
3. Documenter l’API pour expliquer ces contraintes.

Merci d’avance pour votre aide.

Bonjour

EDIT 20250324:

Phénomène encore pire avec 4.9.0
Voir premier transfert de 3,7 GB sur cette vidéo (transfert en 512KB chunk soit 50% de la taille des frame supportées):

https://github.com/nbanb/fbx-delta-nba_bash_api.sh/raw/refs/heads/nbanb-freebox-api/local_direct_ul_api-video-example.webm

/EDIT/

J’ai constaté 2 phénomènes lors de l’utilisation des API qui compliquent leur utilisation:

-1) quand on envoi un certain nombres de requêtes à l’API (avec un rate soutenu), il arrive que l’API renvoit «empty_reply», soit une trame void
Cela arrive aussi lorsque la Freebox reçoit 2 requêtes à ‘l’exacte même moment’

-2) les temps de réponses de l’API sont variables et se dégradent dans le temps même quand la box est globalement peu sollicité, c’est particulièrement flagrant sur l’API upload.

Je précise ici que lors des tests ou j’ai constaté le phénomène, la Freebox et le client sont connectés en 10G et sont à 5m de fibres l’un de l’autre.
Le réseau n’est pas en cause (ni le stockage dans la box qui est composé de 4 SSD en raid)

Pour exemple POC ici: https://transfert.free.fr/6XdwQzi (lien valable 30j)

Regardez la barre de progression qui se base sur les trames ‘upload_data’ renvoyé par l’API pour chaque chunk, parfois on reçoit les retours au bout de plusieurs secondes alors que le débit upload est constant (et qu’on devrait recevoir un ‘stream’ de retour constant)
Cela se constate facilement en regardant la barre de progression et les compteurs à droite qui s’incrémentent pas “rafale”

Aussi et de plus en plus souvent la Freebox met plus d’1 seconde à répondre à la première requête contenant ‘upload_start’.
Ce n’était pas le cas lors des 9 premiers teras upload sur la box mais est devenu régulier depuis les 200 derniers GB transférés.

Y aurait il un phénomène d’essoufflement de la Freebox ? Un buffer nginx saturé / mal réglé ?
Une possibilité pour le user de restart nginx serait super (au travers d’une API system/nginx par exemple)
Ce serait dommage de devoir adapter le code des application clientes en fonction d’une dégradation prévisible des temps de réponses de l’API

Et je n’ai pas très envie de reboot la box (c’est en prod –> pas de reboot)…

En vous remerciant d’avance
Cordialement
nbanba

Bonjour

Il existe au moins 1 cas à priori non documenté ou l’API du player Devialet ne renvoit pas du JSON

Si je fais la requête pour reboot mon player en utilisant le bon ID pour mon player, la réponse est en JSON ⇒ OK

Si je fais volontairement une requête sur un mauvais ID de player, le player renvoit du HTML au lieu de renvoyer du JSON :

Exemple:
La fonction reboot player prend en argument l’ID du player (mon player à pour ID 17)

Si je fais:

reboot_player 17

J’obtiens le JSON:

{"success":true}

Maintenant si je passe un ID erroné volontairement(ex: ID 0), l’API ne renvoi pas une erreur en JSON mais du HTML:
Trace debug:

$ debug=1
$ reboot_player  0
get_fbx_api request:
curl -s https://mafreebox.freebox.fr/api/v14/player -H "Content-Type: application/json" -H "X-Fbx-App-Auth: $_SESSION_TOKEN" -G --cacert /dev/shm/fbx-cacert 

get_fbx_api result:
{"success":true,"result":[{"mac":"34:27:92:80:29:7c","stb_type":"stb_v7","id":17,"last_time_reachable":1742725668,"api_available":true,"device_name":"Freebox Player","device_model":"fbx7hd-delta","reachable":true,"uid":"a51dde83e07a057e64bef5bdcac8c5e2","api_version":"14.0","lan_gids":["ether-34:27:92:80:29:7c"]}]}

post_fbx_api request:
curl -s "https://mafreebox.freebox.fr/api/v14/player/0/api/v14/system/reboot" -H "Content-Type: application/json" -H "X-Fbx-App-Auth: $_SESSION_TOKEN" -X POST --cacert /dev/shm/fbx-cacert -d {}

post_fbx_api result:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Freebox :: Requête invalide</title>
<link href="/err/err.css" rel="stylesheet" type="text/css" />
</head>

<body>
<div id="info">
    <div id="errorMsg">
      <h3>Requête invalide</h3>
      <p class="desc">La requête envoyée est invalide</p>
    </div>
</div>

</body>
</html>

Je comprend bien que c’est du à l’URL qui devient “mauvaise” car l’ID du player est incluse dans l’URL

cette URL n’existe en fait pas:
https://mafreebox.freebox.fr/api/v14/player/0/api/v14/system/reboot

par contre celle-ci existe:
https://mafreebox.freebox.fr/api/v14/player/17/api/v14/system/reboot

Cependant, pour des questions de normalisation et de parsing, il faudrait que l’API renvoi une erreur avec un content-type application/json

Il serait bien de ne pas devoir développer un moteur de parsing HTML en plus du moteur de parsing JSON à cause d’1 seul message d’erreur renvoyé par l’API et “ne respectant à priori pas la convention de cette même API”

Merci

Cordialement
nbanba

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

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.

[EDIT 2025-04-17]

Pour backup, une fois le trafic TLS décrypté, je trouve:

GET /api/latest/backup/config/export

Il est donc maintenant possible de backup régulièrement et en automatique la Freebox, par exemple en utilisant la fonction backup_fbx_config() de la library BASH
[/EDIT 2025-04-17/]

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

Depuis la MàJ 1.3, les fichiers (vidéo, audio, image) nommés avec des caractères cyrilliques ne s’affichent plus dans la liste Freebox Player par ordre alphabétique. Le tri se fait par un ordre aléatoire dur à déterminer et il ne semble pas y avoir de remède à ce problème pour l’utilisateur.

La liste des dessins animés venants des pays slaves ressemble maintenant à cela :

Les souris malines 01
Petits chatons 01
Petits chatons 02
Les renards rigolo
Un ourson gentil 01
Trois lapins pompiers
Deux garçons et un vélo
Petits chatons 03
Les souris malines 02
Petits chatons 04

Donc, il est laborieux pour des parents de trouver le dessin animé demandé par le petit cinéphile et tout simplement impossible pour ce dernier de se faire un marathon des « Petits chatons », par exemple.

Il faut noter, que ce tri mystérieux était présent dans l’interface FreeboxOS depuis déjà long temps, tandis que le Freebox Player réussissait sans problème a trier les alphabets non-latins. Dans l’absolu, il aurait été mieux pour le Server d’apprendre à bien trier et non au Player de l’oublier.

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

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.

J’ai connecté un serveur linux à la freebox via l’API.
Mais depuis quelque temps je n’ai plus d’acces.

J’ai voulu revoqué mon applicatif, mais la freebox me renvoi une erreur.
Impossible de supprimer cet objet.

De plus, quand j’essai de recuperer un nouveau token applicatif, la requete me renvoi une erreur interne:

“msg”: “Base d’authentification indisponible”,

Merci de m’indiquer la meilleure marche a suivre car le SAV me repond qu’ils ne sont pas capable de traiter ce probleme..