A HomeMatic CCU addon providing an XML-based HTTP API to query and control all connected smart home devices.
XML-API is a HomeMatic CCU addon that provides an XML-based HTTP API interface to all devices connected to a CCU (Central Control Unit). It solves the problem of programmatically accessing and controlling a HomeMatic smart home system by offering a set of scripts that return structured XML data over HTTP, enabling integration with external applications and automation tools.
HomeMatic CCU users and developers who need to integrate their smart home system with third-party applications, custom dashboards, or automation scripts via a standardized API.
Developers choose XML-API because it offers a comprehensive, token-secured HTTP interface to the entire HomeMatic ecosystem, eliminating the need for low-level CCU hacking and enabling easy remote control and monitoring through simple web requests.
HomeMatic CCU Addon implementing a xml request functionality
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Provides scripts like devicelist.cgi and state.cgi to query and manage all HomeMatic devices, channels, and states via HTTP, enabling full system control without direct CCU modifications.
Uses stateless token authentication with register, list, and revoke functions via scripts like tokenregister.cgi, securing API access without complex setup.
Offers over 20 dedicated scripts for accessing rooms, functions, protocols, RSSI values, and more, as listed in the README, allowing fine-grained control and integration.
All scripts generate XML-formatted responses, making integration straightforward for applications that can parse XML, with examples provided for each script.
Responses are exclusively in XML, which can be verbose and less efficient for modern web apps that prefer JSON, requiring additional parsing steps and potentially slowing development.
Requires installation as a CCU addon on specific models like CCU3 or RaspberryMatic, limiting portability and adding complexity for users outside the HomeMatic ecosystem.
Some scripts like checkuptodate.cgi have unclear descriptions (marked with ??? in the README), making it harder for users to utilize all features without experimentation or community support.