Services
With ioBroker, you can execute commands or send data to your smart home via a special URL, no matter where you are. This is especially useful if you want to control devices remotely or import external data into your smart home.
These services are part of the smart assistant license. Each use counts as one voice command.
What can I do with this URL?
The URL allows you to send data to your ioBroker system and execute predefined commands. Typical use cases include:
- Controlling devices : for example, switching lights on and off or regulating the heating.
- GPS tracking : Your mobile phone regularly sends its location so that your home can react to your presence.
- Sending sensor data : External systems send measured values such as temperature or humidity to ioBroker.
- Webhook integration : You connect ioBroker to external services such as IFTTT, Tasker or home automation apps.
How does that work?
You call a special URL that your ioBroker system reaches via the cloud adapter:
https://service.iobroker.in/v1/iotService?service=SERVICE_NAME&key=USER_KEY&user=USER_EMAIL&data=myString
Explanation of the parameters
| parameter | Meaning |
|---|---|
service | The name of the command that you previously defined in ioBroker. |
key | Your personal security key. It is generated by the cloud adapter. |
user | Your email address registered in the ioBroker cloud. |
data | The data you want to send, for example, a message or a control command. |
Examples
Turn on the lights via URL
Prerequisite: You have an action in ioBroker with the nameturnOnLight created.
https://service.iobroker.in/v1/iotService?service=turnOnLight&key=DEIN_KEY&user=DEINE_EMAIL&data=on
Send GPS data to the smart home (geofencing)
Your phone regularly sends its location to ioBroker.
https://service.iobroker.in/v1/iotService?service=updateLocation&key=DEIN_KEY&user=DEINE_EMAIL&data={"lat":52.5200,"lng":13.4050}
Send data via POST
If you want to transfer larger amounts of data, you can send a POST request instead of using the address bar. The URL remains the same, but the data is contained in the body of the request.
How do I set up a new service?
- Open the ioBroker admin panel.
- Install and activate the ioBroker.iot adapter.
- Go to the adapter settings and create a new action.
- Specify which data should be received and what happens as a result.
- Remember the name of the action and use it in your URL.
Safety instructions
- Protect your key. Anyone who knows it could unintentionally trigger actions in your smart home.
- Use HTTPS to ensure the connection is encrypted.
- Define secure actions , for example with an additional password or by restricting which IP addresses are allowed to send commands.
Conclusion
The cloud service URL is a powerful feature for controlling your smart home from anywhere or integrating external data. Simple commands allow you to flexibly connect your system to other services for automations, webhooks, or control from your mobile phone.