🚀 Feature Release

  • Virus risk feed is now released. Virus risk events are sent using a new type airthings-webhook-cloudevent-virus-risk-feed

  • Hub metadata feed is now released. Hub events are sent using a new type hub-meta-data-feed and can be selected
    with the other devices/locations in the Dashboard.

About once every hour, the Hub sends metadata to the Airthings cloud informing us about its current status. A few example fields are connectionType (ethernet or cellular), lastSeenDevices(devices seen by the hub within the last 15 minutes), and devices, which shows all devices paired to the hub.

An example event:

{
  "id": "cb0bb746-cdb3-42b5-8a96-db88380e5513",
  "type": "airthings-webhook-cloudevent-hub-meta-data-feed",
  "source": "https://dashboard.airthings.com/integrations/webhooks/f278e95b-26e2-4942-8374-175611b98c36",
  "dataContentType": "application/json",
  "labels": {},
  "data": {
    "serialNumber": "2820000001",
    "recorded": "2020-11-13T13:46:08",
    "lastSeenDevices": [
      "2930000001"
    ],
    "devices": {
      "2930000001": {
        "lastSeen": 1598065353,
        "rssi": -57,
        "type": "wavePlus"
      }
    },
    "connectionType": "ethernet"
  },
  "time": "2020-11-13T13:46:10.280000",
  "specVersion": "0.2"
}

Improvement

  • Two new properties have been added to the data object: rssi (signal strength of the device) and batteryPercentage.

🚀 Feature Release

Two endpoints have been added for fetching full history of samples for virus risk values:

  • /devices/{serialNumber}/virus-risk-samples
  • /segments/{segmentId}/virus-risk-samples

This is considered a beta feature, and it might change in the future.

Improvements

  • Virus risk sensor values has been added to /latest-samples for devices and locations.

Improvements

Properties active and started have been added to the segment object to the /devices and /locations endpoints. The active field is used to distinguish between devices that are currently paired to an account and devices that have been unpaired and removed from the account, but still have historical measurements.

The segment object now has the following structure:

{
  "id": "91f7fc45-8006-4279-9b0a-fa8b812020fa",
  "name": "My device name",
  "started": "2020-08-07T06:53:04",
  "active": true
}

🚀 Feature Release

Two endpoints have been added for fetching full history of samples for mold values:

  • /devices/{serialNumber}/mold-samples
  • /segments/{segmentId}/mold-samples

This is considered a beta feature, and it might change in the future.

🚀 Feature Release

The webhooks will now receive an event when a new mold risk indicator value is calculated. The event type will be airthings-webhook-cloudevent-virtual-sample-feed for these samples.

Improvements

  • Mold sensor values has been added to /latest-samples for devices and locations.

Improvements

  • Samples in the API now also returns light data.

📝 Documentation

  • The website has been updated with swagger documentation, the swagger was previously hosted in accounts.airthings.com. It can now be found here: API documentation.

Improvements

  • A correction has been made to the samples API to provide appropriate rounding, i.e. rounding in-line with the precision of the sensors.
  • Pressure sensor unit has been updated to return hPA instead of Pa.