Ondersteuning bij de ontwikkeling
Informatie over de interfaces en protocollen van de FRITZ!Box
Wij waarderen je interesse nieuwe producten voor de FRITZ!Box-familie te ontwikkelen. Op dit gebied zijn er al verschillende projecten met diverse benaderingen en technische richtingen. FRITZ! neemt daarbij in principe een neutrale positie in.
In zijn huidige versie ondersteunt de FRITZ!Box l diverse ontwikkelingsprojecten van onafhankelijke aanbieders. Hiervoor staan open en gestandaardiseerde interfaces tot jouw beschikking, die wij binnen de FRITZ!Box-systeemarchitectuur ondersteunen.
Daarnaast vind je op deze pagina uitgebreide hulp voor geselecteerde implementatie-ideeën. We wensen je veel succes met de uitvoering!
Het volgende document beschrijft de wijzigingen en geeft aanbevelingen voor gebruikersbegeleiding bij het aanmelden bij een FRITZ!Box. Het document is bedoeld voor ontwikkelaars die toepassingen van derden voor de FRITZ!Box programmeren. Vanuit het oogpunt van gebruiksvriendelijkheid wordt ontwikkelaars van toepassingen van derden sterk aanbevolen om de gebruikersbegeleiding en terminologie af te stemmen op het voor de gebruiker vertrouwde gedrag van de FRITZ!Box-interface.
TR-064 is een protocol ontwikkeld door het Broadband Forum om internetrouters vanuit het lokale netwerk te configureren. Het is gebaseerd op de UPnP-standaard (Universal Plug and Play), die algemeen wordt gebruikt voor het fabrikant-onafhankelijk aansturen van apparaten in IP-netwerken. De bij UPnP en daarmee ook bij TR-064 gebruikte multicastadressen komen uit een adresbereik dat niet gerouteerd wordt. De FRITZ!Box is daarom alleen met TR-064 toegankelijk vanuit het eigen lokale netwerk.
Voor communicatie is over het algemeen een softwareclient nodig die TR-064 ondersteunt. Met deze client kun je eenvoudig de status van de FRITZ!Box opvragen en handmatig of via een configuratiebestand bepaalde parameters van de FRITZ!Box instellen, zoals bijvoorbeeld de toegangsgegevens voor de internetverbinding.
Dit document geeft je een overzicht van alle aangeboden functies:
Dit document geeft je een overzicht van de eerste stappen bij het realiseren van een ontwikkelingsproject:
- TR-064 – First Steps (PDF)
Stand: 10.10.2024
Dit document geeft een overzicht van de door ons ondersteunde diensten en documenten voor het TR-064 protocol:
- TR-064 – Overview (PDF)
Stand: 10.10.2024
Alle uitbreidingen voor de FRITZ!Box zijn gebaseerd op de standaard TR-064.
| Service | Omschrijving | Download | Datum |
|---|---|---|---|
| WAN | |||
| WANIPConnection | WAN-configuratie, TR-064-service in IP-verbindingsmodus (bijv. kabel, IP-client), verbindingsstatus, het tot stand brengen en verbreken van je internetverbinding, internettoegangsgegevens, poortvrijgave, externe IP-adres, DNS-servers | TR-064_WAN_IP_Connection.pdf | 8-9-2021 |
| WANPPPConnection | WAN-configuratie, TR-064-service in PPPoE-verbindingsmodus (bijvoorbeeld DSL), verbindingsstatus, het tot stand brengen en verbreken van je internetverbinding, internettoegangsgegevens, poortvrijgaven, externe IP-adres, DNS-servers | TR-064_WAN_PPP_Connection.pdf | 8-9-2021 |
| WANFiber | TR-064-services voor glasvezelverbindingen | TR-064_WAN_Fiber.pdf | 30-8-2023 (nieuw voor FRITZ!OS 8) |
| WANCommonInterfaceConfig | WAN-statistieken, onlinemonitor, fysiek WAN-toegangstype en status | TR-064_WAN_Common_Interface_Config.pdf | 20-1-2023 |
| WANEthernetLinkConfig | Ethernet-linkstatus | TR-064_WAN_Ethernet_Link_Config.pdf | 15-7-2009 |
| WANDSLInterfaceConfig | DSL-informatie (CRC, gegevenssnelheden, SNR, …) en DSL-diagnose (bijvoorbeeld detectie van kabelbreuken) | TR-064_WAN_DSL_Interface_Config.pdf | 1-11-2019 |
| WANDSLLinkConfig | VCC-instellingen, ATM-statistieken | TR-064_WAN_DSL_Link_Config.pdf | 17-10-2022 |
| X_AVM-DE_WANMobileConnection | TR-064-ondersteuning voor FRITZ!-apparaten met internettoegang via mobiel netwerk (5G/4G) | TR-064_WAN_Mobile_Connection.pdf | 10-10-2024 (nieuw voor FRITZ!OS 8) |
| X_AVM-DE_Speedtest | Metingen van de doorvoersnelheid | TR-064_Speedtest.pdf | 10-1-2022 |
| X_AVM-DE_RemoteAccess | Dynamic DNS, onderhoud op afstand | TR-064_Remote_Access_SCPD.pdf | 17-10-2022 |
| TR-064_Remote_Access.pdf | 15-8-2018 | ||
| X_AVM-DE_MyFritz | Toegang op afstand, MyFRITZ!, dynamic DNS | TR-064_MyFRITZ.pdf | 14-2-2022 |
| X_AVM-DE_HostFilter | Ouderlijk toezicht, internetblokkering | TR-064_Host_Filter.pdf | 11-2-2022 |
| Layer3Forwarding | IP-netwerkroutes, WAN-verbindingstype | TR-064_Layer_3_Forwarding.pdf | 15-7-2009 |
| Telefonie | |||
| X_AVM-DE_OnTel | Telefoonboek, onlinetelefoonboek, oproeplijsten, oproepblokkeringen, doorschakelingen | TR-064_Contact_SCPD.pdf | 10-10-2024 (nieuw voor FRITZ!OS 8) |
| X_AVM-DE_TAM | Antwoordapparaat, oproeplijst | TR-064_TAM.pdf | 14-2-2022 |
| X_VoIP | Instellen provider voor internettelefonie, instellen LAN-/IP-telefoon, kieshulp, SIP-nevenaansluitingen | TR-064_VoIP.pdf | 14-2-2022 |
| Thuisnetwerk | |||
| LanDeviceHosts | Thuisnetwerkapparaten, Wake-on-LAN, FRITZ! Mesh | TR-064_Hosts.pdf | 10-10-2024 (nieuw voor FRITZ!OS 8) |
| WLANConfiguration | Wi-Fi-configuratie en statistiek, Wi-Fi-netwerkapparaten | TR-064_WLAN_Configuration.pdf | 10-10-2024 (nieuw voor FRITZ!OS 8) |
| LANHostConfigManagement | Netwerkinstellingen, DHCP-servers, IP-adresbereiken, subnetmasker | TR-064_LAN_Host_Config_Management.pdf | 20-11-2015 |
| LANEthernetInterfaceConfig | LAN-interface en statistieken (Pakketteller) | TR-064_LAN_Ethernet_Interface_Config.pdf | 15-7-2009 |
| X_AVM-DE_Dect | DECT-apparaten | TR-064_DECT.pdf | 17-10-2022 |
| X_AVM-DE_Media | TR-064 voor FRITZ!-producten met DVB-C-ondersteuning (bijvoorbeeld FRITZ!Box Cable) | TR-064_Media.pdf | 25-2-2022 |
| X_HomeAuto | Smarthomeapparaten | TR-064_HomeAuto.pdf | 11-2-2022 |
| X_HomePlug | Powerlineapparaten | TR-064_HomePlug.pdf | 11-2-2022 |
| Opslag/NAS | |||
| X_AVM-DE_Storage | Instellingen voor SMB, FTP | TR-064_Storage.pdf | 14-2-2022 |
| X_AVM-DE_UPnP | UPnP-AV-mediaserver | TR-064_UPnP.pdf | 22-9-2009 |
| X_AVM-DE_WebDAV | Instellen online-opslag/WebDAV | TR-064_WebDAV.pdf | 18-9-2009 |
| X_AVM-DE_Filelinks | Gedeelde bestanden | TR-064_Filelinks.pdf | 7-7-2016 |
| Systeem | |||
| DeviceInfo | Productinformatie, gebeurtenissen, TR-069 provisioning code, security port voor TR-064 | TR-064_Device_Info.pdf | 10-10-2024 (nieuw voor FRITZ!OS 8) |
| DeviceConfig | Back-up van de instellingen maken, instellingen herstellen, fabrieksinstellingen, opnieuw opstarten, SID-generatie | TR-064_Device_Config.pdf | 16-2-2022 |
| LANConfigSecurity | Gebruikerslijsten en FRITZ!Box-wachtwoord | TR-064_LAN_Config_Security.pdf | 7-6-2022 |
| X_AVM-DE_AppSetup | Beheer van apps (VPN, messagefilter, rechten, toegang op afstand) | TR-064_App_Setup.pdf | 17-2-2022 |
| ManagementService | TR-069-configuratie | TR-064_Management_Server.pdf | 23-1-2013 |
| X_AVM-DE_USPController | TR-064-ondersteuning voor het USP-protocol (User Services Platform / TR-369) | TR-064_USP_Controller.pdf | 7-10-2022 |
| X_AVM-DE_Auth | Tweefactorauthenticatie | TR-064_Authentication.pdf | 11-2-2022 |
| Time | Tijdserver (NTP) | TR-064_Time.pdf | 15-2-2022 |
| UserInterface | Firmware-informatie en updates, taalinstellingen | TR-064_User_Interface.pdf | 10-10-2024 (nieuw voor FRITZ!OS 8) |
| Informatie via UPnP op te vragen | |||
| Internet Gateway Device Spec v1.0 | Het eindapparaat stelt via UPnP informatie over de WAN-verbinding beschikbaar, die zonder authenticatie kan worden opgevraagd. | IGD_v1.pdf | 20-1-2023 |
| Internet Gateway Device Spec v2.0 | IGD_v2.pdf | 20-1-2023 | |
De overdracht van de relevante QoS-parameters gebeurt via X-RTP-Stat-headerinformatie in de SIP-BYE Message. Hier zijn de benodigde gegevens samengevat:
Hier worden de instellingen uitgelegd die een internetprovider kan gebruiken om de QoS-parameters (Quality of Service) voor een FRITZ!Box optimaal te configureren:
Session ID
Het gebruik van sessie-ID’s biedt effectieve bescherming tegen zogenaamde Cross-Site Request Forgery-aanvallen (CSRF), waarbij een kwaadwillige ongeoorloofd gegevens in een webapplicatie probeert te wijzigen. Het volgende document gaat over het gebruik van sessie-ID's en is bedoeld voor ontwikkelaars die tools voor de FRITZ!Box programmeren.
- Session-ID (PDF)
Stand: 03.05.2021
AHA-HTTP-Interface
De documentatie van de HTTP-interface voor het aansturen van FRITZ!-producten voor huisautomatisering (bijv. FRITZ!Smart Energy 200/301/302/440/500) maakt het mogelijk om deze producten te bedienen via een externe applicatie. De apparaten moeten zich daarvoor in het thuisnetwerk van de FRITZ!Box bevinden en via de gebruikersinterface kunnen worden in- en uitgeschakeld. Om alle functies van de interface te kunnen gebruiken, is de actuele releaseversie van FRITZ!OS vereist. Details hierover zijn beschreven in de history van de documentatie.
- AHA HTTP Interface (PDF)
Stand: 21.10.2024 (Neu für FRITZ!OS 8)
Hier wordt de IPv6-ondersteuning in de FRITZ!Box uitgelegd:
Hier wordt de in JSON-indeling beschikbare Mesh-topologie van een FRITZ!Box uitgelegd, evenals veelgestelde vragen over de interpretatie ervan beantwoord:
- Mesh Topology (PDF)
- Mesh Topology Schema v7.8 (JSON)
Stand: 10.10.2024 (Neu für FRITZ!OS 8)
Feedback over de documenten die op deze pagina beschikbaar zijn, ontvangen wij graag via Entwicklungssupport@avm.de.
Als je via dit adres contact met ons opneemt, werk je apparaten dan van tevoren bij met de nieuwste firmware en voeg de onder http://fritz.box/support.lua aangemaakte supportgegevens als bijlage toe.
Opmerking:Let op merk- en auteursrechten
Houd bij je eigen ontwikkeling altijd rekening met de merk- en auteursrechten van FRITZ!. Wij raden je aan de richtlijnen van het merkenrecht te volgen en een eigen productnaam te kiezen, waarbij bijvoorbeeld ‘FRITZ!’ of ‘F!’ niet als fabrikant, partner, sponsor of iets dergelijks kunnen worden beschouwd in het kader van een dergelijke ontwikkeling/toepassing. Er moet ook worden gegarandeerd dat er geen negatieve gevolgen zijn voor FRITZ!-producten en -diensten of FRITZ!-merken (bijvoorbeeld reputatieschade). Verder is het gebruik van grafische elementen, zoals het FRITZ!-logo en het F!-logo, evenals het overnemen van grafische elementen uit FRITZ!-producten, zoals de FRITZ!Box-gebruikersinterface, uitgesloten. In de concrete uitvoering betreft dit onder andere zowel het gebruik van FRITZ!-logo’s als de vermelding van onze merken, in het bijzonder ‘FRITZ!’ / ‘F!’ of ‘FRITZ!Box’, in de productnaam van een productontwikkeling door een andere distributeur. Het gebruik van vergelijkbare tekens kan in individuele gevallen en binnen bepaalde grenzen zijn toegestaan, mits ze uitsluitend worden gebruikt om bepaalde kenmerken of eigenschappen te beschrijven. Ook een verwijzing naar de geschiktheid van het nieuw ontwikkelde product (bijvoorbeeld: ‘Productnaam-van-de-voorbeeld-app, adresbeheer voor FRITZ!Box’) in een onderregel of een doorlopende tekst is in individuele gevallen en binnen bepaalde grenzen toegestaan.
Belangrijk:uitsluiting van aansprakelijkheid en garantie
Wij aanvaarden geen aansprakelijkheid of garantie voor alle genoemde functies en de juistheid van de bijbehorende documentatie. Wij behouden ons het recht voor om functies te allen tijde en zonder voorafgaande kennisgeving geheel of gedeeltelijk te wijzigen of te schrappen.
