Le Hardsoft

To discover a Freebox supporting this API you can either use mDNS, or make a HTTP request to mafreebox.freebox.fr to get API information.

Discovery using mDNS¶

http://dev.freebox.fr/sdk/os/ 

This is the preferred method since it does not require to know the Freebox IP address.

The Freebox broadcasts the “_fbx-api._tcp” service

On iOS devices, you can use a NSNetServiceBrowser

On Android devices, you can use Network Service Discovery or JmDNS

On the TXT record you can obtain the following information:

Key
Description

api_version
The current API version on the Freebox

device_type
“FreeboxServer1,1” for the Freebox Server revision 1,1

api_base_url
The API root path on the HTTP server

uid
The device unique id

Discovery using HTTP¶

If you can, avoid this method because it requires to use a hardcoded address to retreive API information.

If you make a HTTP get request on http://mafreebox.freebox.fr/api_version you can get the same API information as provided in mDNS.