Entwicklungssupport - Schnittstellen
AVM Inhalt
Herzlich willkommen auf unserer Informationseite zu Schnittstellen und Protokollen rund um FRITZ!Box.
Wir freuen uns sehr über Ihr Interesse an einer möglichen Produktentwicklung im Umfeld der FRITZ!Box-Produktfamilie. Im Markt sind zu diesem Thema Projekte mit verschiedenen Ansätzen und unterschiedlicher technischer Expertise aktiv. Hierzu nimmt AVM grundsätzlich eine neutrale Position ein.
Die FRITZ!Box-Linie bietet in der aktuellen Ausprägung bereits Unterstützung für Entwicklungsvorhaben von unabhängigen Anbietern. Genutzt werden offene bzw. standardisierte Schnittstellen, die AVM im Rahmen der Systemarchitektur der FRITZ!Box unterstützt.
Darüber hinaus bietet AVM auf diesen Seiten für ausgewählte Realisierungsansätze eine erweiterte Unterstützung als Download an. Hier finden Sie die aktuelle Zusammenstellung von Informationen und Links.
Anmeldeverfahren an einer FRITZ!Box/FRITZ!Box login process
Anmeldeverfahren an einer FRITZ!Box
Das folgende Dokument beschreibt die Änderungen und gibt Empfehlungen zur Benutzerführung bei der Anmeldung an einer FRITZ!Box. Das Dokument richtet sich an Entwickler, die Drittanwendungen für die FRITZ!Box programmieren. Aus Usability-Gesichtspunkten wird Entwicklern von Drittanwendungen stark empfohlen, die Benutzerführung und die Begriffe an das für den Anwender gewohnte Verhalten der FRITZ!Box-Oberfläche anzugleichen.
Empfehlungen zur Benutzerführung bei der Anmeldung an einer FRITZ!Box_v1.1.pdf
🇬🇧 FRITZ!Box login process
The document below describes the changes and provides recommendations for user guidance for logging into a FRITZ!Box. The document is intended for developers who program third-party applications for FRITZ!Box. From a usability point of view, developers of third-party applications are strongly recommended to adapt their user interface and terms to the behavior of the FRITZ!Box interface, which is familiar to the user.
Recommendations for user guidance for logging in to a FRITZ!Box_v1.1_EN.pdf
Apps / TR-064
TR-064 ist ein vom DSL-Forum entwickeltes Protokoll, um DSL-Internetzugangsgeräte aus dem lokalen Netz zu konfigurieren. Es basiert auf dem UPnP-Standard (Universal Plug and Play), der allgemein zur herstellerübergreifenden Ansteuerung von Geräten in IP-basierten Netzwerken dient. Die bei UPnP und somit auch bei TR-064 zum Einsatz kommenden Multicast-Adressen stammen aus einem Adressbereich, der nicht geroutet wird. Ein Zugriff auf die FRITZ!Box mit TR-064 ist daher nur aus dem eigenen lokalen Netzwerk möglich.
Generell wird für die Kommunikation ein Software-Client benötigt, der TR-064 unterstützt. Über diesen Client können Statusabfragen der FRITZ!Box erfolgen sowie manuell oder über eine Konfigurationsdatei bestimmte Parameter der FRITZ!Box gesetzt werden, beispielsweise die Zugangsdaten für die Internetverbindung.
Einen Überblick über die angebotenen Funktionen finden Sie hier: AVM Technical Note - Konfiguration über TR-064.pdf
Dieses Dokument liefert eine Übersicht über die ersten Schritte bei der Umsetzung eines Entwicklungsvorhabens: AVM TR-064 first_steps.pdf (Stand 18.11.2022)
Dieses Dokument listet die von AVM unterstützten Dokumente zum TR-064-Protokoll auf: AVM_TR-064_overview.pdf (Stand 01.12.2022)
Alle Erweiterungen für die FRITZ!Box beziehen sich auf den TR-064 Standard: http://www.broadband-forum.org/technical/trlist.php
Bereich | Service | Beschreibung | Datum | Download |
WAN | ||||
WANIPConnection | WAN Konfiguration, TR-064-Service im Verbindungsmodus IP (zB. Cable, IP-Client)) Verbindungsstatus, Auf- und Abbau der Internetverbindung, Internetzugangsdaten, Portfreigaben, externe IP-Adresse, DNS Server | 08.09.2021 | ||
WANPPPConnection | WAN Konfiguration, TR-064-Service im Verbindungsmodus PPPoE (z.B. DSL) Verbindungsstatus, Auf- und Abbau der Internetverbindung, Internetzugangsdaten, Portfreigaben, externe IP-Adresse, DNS Server | 08.09.2021 | ||
WANCommonInterfaceConfig | WAN-Statistiken, Online Monitor, physikalischer WAN Zugangstyp und Status | 20.01.2023 | ||
WANEthernetLinkConfig | Ethernet-Linkstatus | 15.07.09 | ||
WANDSLInterfaceConfig | DSL-Informationen (CRC, Datenraten, SNR, ...), DSL-Diagnose (zB. Detektion von Kabelbrüchen) | 01.11.19 | ||
WANDSLLinkConfig | VCC-Einstellungen, ATM-Statistiken | 17.10.2022 | ||
X_AVM-DE_WANMobileConnection | TR-064 Unterstützung für AVM-Produkte mit Internetzugang über Mobilfunk (LTE/5G). | 18.11.2022 | ||
X_AVM-DE_Speedtest | Datendurchsatzmessungen | 10.01.2022 | ||
X_AVM-DE_RemoteAccess | Dynamic DNS, Fernwartung | 17.10.2022 | ||
15.08.18 | ||||
X_AVM-DE_MyFritz | Fernzugang, MyFritz, Dynamic DNS | 14.02.2022 | ||
X_AVM-DE_HostFilter | Kindersicherung, Internetsperre | 11.02.2022 | ||
Layer3Forwarding | IP Netzwerkrouten, WAN Verbindungstyp | 15.07.09 | ||
Telefonie | ||||
X_AVM-DE_OnTel | Telefonbuch, Online-Telefonbuch, Anrufliste, Rufsperren, Rufweiterleitung | 19.01.2023 | ||
X_AVM-DE_TAM | Anrufbeantworter, Anrufliste | 14.02.2022 | ||
X_VoIP | Einrichtung Internettelefonie-Anbieter, Einrichtung LAN/IP-Telefon, Wählhilfe, SIP-Nebenstellen | 14.02.2022 | ||
Heimnetz | ||||
LanDeviceHosts | Heimnetzgeräte, Wake-on-LAN, FRITZ!Mesh | 13.10.2022 | ||
WLANConfiguration | WLAN Konfiguration und Statistik, WLAN Netzwerkgeräte | 13.10.2022 | ||
LANHostConfigManagement | Netzwerkeinstellungen, DHCP-Server, IP-Adressbereiche, Subnetzmaske | 20.11.2015 | ||
LANEthernetInterfaceConfig | LAN-Schnittstelle und Statistiken (Paketzähler) | 15.07.09 | ||
X_AVM-DE_Dect | DECT-Geräte | 17.10.2022 | ||
🆕 X_AVM-DE_Media | TR-064 für AVM Produkte - FRITZ!Box Cable - mit DVBC-Unterstützung | 25.02.2022 | ||
X_HomeAuto | SmartHome-Geräte | 11.02.2022 | ||
X_HomePlug | Powerline-Geräte | 11.02.2022 | ||
Speicher/NAS | ||||
X_AVM-DE_Storage | Einstellungen für SMB, FTP | 14.02.2022 | ||
X_AVM-DE_UPnP | UPnP AV Mediaserver | 22.09.09 | ||
Einrichtung Online-Speicher/WebDAV | 18.09.09 | |||
X_AVM-DE_Filelinks | Dateifreigaben | 07.07.16 | ||
System | ||||
DeviceInfo | Produktinformation, Ereignisse, TR-069 Provisioning Code, Security Port für TR-064 | 16.02.2022 | ||
DeviceConfig | Einstellungen sichern/wiederherstellen, Werkseinstellungen, Neustart, SID Generierung | 16.02.2022 | ||
LANConfigSecurity | Benutzerlisten und FRITZ!Box Kennwort | 07.06.2022 | ||
X_AVM-DE_AppSetup | Verwalten von Apps (VPN, Messagefilter, Rechte, Remotezugriff) | 17.20.2022 | ||
ManagementService | TR-069-Konfiguration | 23.01.13 | ||
🆕 X_AVM-DE_USPController | TR-064 Unterstützung für das USP-Protokoll (User Services Platform/TR-369) | 07.10.2022 | ||
X_AVM-DE_Auth | 2-Faktor-Authentisierung | 11.02.2022 | ||
Time | Zeitserver (NTP) | 15.02.2022 | ||
UserInterface | Firmwareinformationen und Update, Spracheinstellungen | 17.10.2022 | ||
Informationen über UPnP abrufbar | ||||
Internet Gateway Device Spec v1.0 | Das Endgerät stellt über UPnP Informationen zur WAN-Verbindung bereit die ohne Authentisierung abgefragt werden können. | 20.01.2023 | ||
Internet Gateway Device Spec v2.0 | 20.01.2023 |
SIP
Die Übertragung der relevanten QoS-Parameter erfolgt mittels X-RTP-Stat Header Information in der SIP-BYE Message. In diesem Dokument sind die erforderlichen Details zusammengefasst.
Format of the Transmission of QoS-Parameters via SIP-Bye-Message - xrtpv32.pdf
PPP
Einstellungen, die ein Provider nutzen kann, um die QoS-Parameter (Quality of Service) für eine FRITZ!Box optimal zu konfigurieren.
HTTP
Session ID
Die Verwendung von Session-IDs bietet einen wirksamen Schutz vor sogenannten Cross-Site Request Forgery-Angriffen, bei denen ein Angreifer unberechtigt Daten in einer Webanwendung verändert. Das folgende Dokument beschäftigt sich mit der Verwendung von Session-IDs und richtet sich an Entwickler, die Tools für die FRITZ!Box programmieren.
AHA-HTTP-Interface
Die Dokumentation der HTTP-Schnittstelle zur Ansteuerung von AVM-Produkten zur Hausautomation (z.B. FRITZ!DECT 200/301/302/440/500) ermöglicht die Steuerung dieser Produkte durch eine externe Applikation. Die Geräte müssen dazu im Heimnetz der FRITZ!Box vorhanden und über die Benutzeroberfläche schaltbar sein. Um alle Funktionen der Schnittstelle nutzen zu können, ist der Einsatz der aktuellen Releaseversion von FRITZ!OS erforderlich. Details dazu sind in der History der Dokumentation beschrieben.
Nr. | Datum | Beschreibung | Download |
| Session ID | ||
1 | 03.05.21 | Deutsch | |
2 | 03.05.21 | Englisch | |
AHA-HTTP-Interface | |||
1 | 19.09.2022 | Version 1.57 |
IPv6
IPv6-Unterstützung in der FRITZ!Box
Mesh-Topologie
Mit diesem Dokument wird die im JSON Format bereitgestellte Mesh-Topologie einer FRITZ!Box erklärt sowie häufig gestellte Fragen zur Interpretation beantwortet.
This document explains the mesh topology of FRITZ!Box provided in JSON format and answers frequently asked questions regarding its interpretation.
Mesh Topology Schema v4.11 (JSON)
Stand: 08.02.2023
Hinweise zu den auf dieser Seite zur Verfügung gestellten Dokumenten nehmen wir gerne unter Entwicklungssupport@avm.de auf. Wir wünschen Ihnen viel Erfolg bei der Umsetzung.
Falls Sie uns über diese Adresse anschreiben, bitten wir darum, Ihre Geräte vorher auf einen aktuellen Firmwarestand zu bringen und die unter http://fritz.box/support.lua erzeugte Datei im Anhang mitzusenden.
Hinweise zu Marken- und Urheberrechten
Bitte beachten Sie im Vorfeld einer eigenen Entwicklung auch die Marken- und Urheberrechte von AVM. Wir möchten an dieser Stelle empfehlen, den Aussagen des Markenrechts zu folgen und eine eigenständige Produktbezeichnung zu wählen, mit der beispielsweise "AVM" oder "FRITZ!" / "F!" nicht als Hersteller, Partner, Förderer o. ä. im Rahmen einer solchen Entwicklung/Anwendung angesehen werden können. Sichergestellt sein muss ferner, dass keine negativen Auswirkungen auf AVM, AVM-Produkte und -Dienstleistungen oder AVM-Marken erfolgen (z.B. Rufschädigungen). Weiterhin sind die Verwendung von grafischen Elementen, wie AVM-Logo, FRITZ!-Logo und F!-Logo , sowie die Übernahme von grafischen Elementen aus AVM-Produkten, wie der FRITZ!Box-Benutzeroberfläche, ausgeschlossen. In der konkreten Umsetzung betrifft dies unter Anderem sowohl die Verwendung von FRITZ!-Logos als auch die Nennung unserer Marken, insbesondere "FRITZ!" / "F!" oder "FRITZ!Box", im Produktnamen einer Produktentwicklung durch einen anderen Inverkehrbringer als AVM. Als reine Angabe über bestimmte Merkmale oder Eigenschaften kann die Nutzung vergleichbarer Zeichen im Einzelfall und in bestimmtem Umfang zulässig sein. Auch ein Hinweis auf die Eignung des neu entwickelten Produkts (Beispiel: "Produktnamen-der-Muster-App, Adressverwaltung für FRITZ!Box") in einer Unterzeile oder einem Fließtext ist im Einzelfall und in bestimmtem Umfang zulässig.
Haftungs- und Gewährleistungsausschluss
Für alle genannten Funktionen sowie die Richtigkeit der zugehörigen Dokumentation wird von AVM keine Haftung oder Gewährleistung übernommen. AVM behält sich vor, jederzeit und ohne vorherige Ankündigung Funktionen ganz oder teilweise zu ändern oder entfallen lassen zu können.
Deutschland
International (English)
Österreich
Nederland
España
Italia
Polska
België (Nederlands)
Luxemburg (Deutsch)
Schweiz (Deutsch)