We have developed connectivity API for integration, control and telemetry collection from our devices. This documentation is intended for third party integrators, that would like to control Shelly devices that are connected to our cloud systems. An integrator account is needed and for obtaining a license one you should contact us at email@example.com. Licenses for personal use are not provided. Our users have to log into their Shelly Cloud account to give consent for sharing a set of their devices. They can also revoke that consent later.
To acquire integrator account you should contact us as stated above. What you'll
token unique identifiers.
Use the provided integrator
token to acquire JWT (Access Token valid
24h) used for issuing WSS connection. Valid JWT is required when issuing a new
connection. The connection can persist indefinitely.
curl -X POST 'https://api.shelly.cloud/integrator/get_access_token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'itg=<INTEGRATOR_TAG>' \
Web Socket Connection
Open web sockets connection and authenticate with the JWT.
There are multiple Shelly cloud servers, each user and his/hers devices always connect to the same server. The WSS connection to a shelly server will receive the data for all devices with enabled integration connected to that server. Keep in main that more than one open socket may be needed.
Server location will be provided on device registration with the
parameter. Integrator must keep at-least one open connections to a server, where
it has active users.