Streetlights API
1.0.0

The Smartylighting Streetlights API allows you to remotely manage the city lights.

Check out its awesome features:
  • Turn a specific streetlight on/off 🌃
  • Dim a specific streetlight 😎
  • Receive real-time information about environmental lighting conditions 📈

This is the documentation for version 1.0.0 of the API. Last update on Feb 25, 2021.

This API is provided under license Apache 2.0.

Protocol: mqtt
test.mosquitto.org:{port}

Inform about environmental lighting conditions of a particular streetlight.

PUB smartylighting/streetlights/1/0/event/{streetlightId}/lighting/measured

The topic on which measured values may be produced and consumed.

PUBLISH smartylighting/streetlights/1/0/event/{streetlightId}/lighting/measured

Light measured

Inform about environmental lighting conditions of a particular streetlight.

Headers

Payload

  • lumens integer

    Light intensity measured in lumens.

    Minimum value is 0.

  • sentAt string(date-time)

    Date and time when the message was sent.

Headers example
{
  "my-app-header": 42
}
Payload example
{
  "lumens": 42,
  "sentAt": "2023-05-04T09:42:00+00:00"
}