Maker API Request - add last updated date to device info response

🚧 Developers
1

In my app I have an option to sort devices by last updated. This worked when I was using the 'all devices w/full details' URL (ie: devices/all) because it returns a date field with the last updated date.

However, because that API response was so slow I'm not calling all devices and then fetching the full details of each device individually (ie: devices/131).

But, this response doesn't contain the date field.

Is there any reason why it's missing? Since this is JSON, could it be added knowing that it won't break existing clients that use the Maker API?

2

here's examples to show what I mean.. same device in 2 different responses:

/devices/all 
  {
    "name": "Generic ZigBee RGBW Light",
    "label": "LED3",
    "type": "Generic ZigBee RGBW Light",
    "id": "131",
    "date": "2020-06-15T21:13:20+0000",
    "model": null,
    "manufacturer": null,
    "capabilities": [
      "Switch",
      "Configuration",
      "SwitchLevel",
      "Refresh",
      "ColorControl",
      "Actuator",
      "ColorTemperature",
      "Light",
      "ChangeLevel",
      "ColorMode"
    ],
    "attributes": {
      "RGB": null,
      "dataType": "ENUM",
      "values": [
        "on",
        "off"
      ],
      "color": null,
      "colorMode": "RGB",
      "colorName": "Chartreuse",
      "colorTemperature": "2702",
      "hue": "22",
      "level": "100",
      "saturation": "100",
      "switch": "on"
    },
    "commands": [
      {
        "command": "configure"
      },
      {
        "command": "off"
      },
      {
        "command": "off"
      },
      {
        "command": "on"
      },
      {
        "command": "on"
      },
      {
        "command": "refresh"
      },
      {
        "command": "setColor"
      },
      {
        "command": "setColorTemperature"
      },
      {
        "command": "setHue"
      },
      {
        "command": "setLevel"
      },
      {
        "command": "setSaturation"
      },
      {
        "command": "startLevelChange"
      },
      {
        "command": "stopLevelChange"
      }
    ]
  },
/devices/131 
{
  "id": "131",
  "name": "Generic ZigBee RGBW Light",
  "label": "LED3",
  "attributes": [
    {
      "name": "RGB",
      "currentValue": null,
      "dataType": "STRING"
    },
    {
      "name": "color",
      "currentValue": null,
      "dataType": "STRING"
    },
    {
      "name": "colorMode",
      "currentValue": "RGB",
      "dataType": "ENUM",
      "values": [
        "CT",
        "RGB"
      ]
    },
    {
      "name": "colorName",
      "currentValue": "Chartreuse",
      "dataType": "STRING"
    },
    {
      "name": "colorName",
      "currentValue": "Chartreuse",
      "dataType": "STRING"
    },
    {
      "name": "colorTemperature",
      "currentValue": 2702,
      "dataType": "NUMBER"
    },
    {
      "name": "hue",
      "currentValue": 22,
      "dataType": "NUMBER"
    },
    {
      "name": "level",
      "currentValue": 100,
      "dataType": "NUMBER"
    },
    {
      "name": "saturation",
      "currentValue": 100,
      "dataType": "NUMBER"
    },
    {
      "name": "switch",
      "currentValue": "on",
      "dataType": "ENUM",
      "values": [
        "on",
        "off"
      ]
    },
    {
      "name": "switch",
      "currentValue": "on",
      "dataType": "ENUM",
      "values": [
        "on",
        "off"
      ]
    }
  ],
  "capabilities": [
    "Switch",
    {
      "attributes": [
        {
          "name": "switch",
          "dataType": null
        }
      ]
    },
    "Configuration",
    "SwitchLevel",
    {
      "attributes": [
        {
          "name": "level",
          "dataType": null
        }
      ]
    },
    "Refresh",
    "ColorControl",
    {
      "attributes": [
        {
          "name": "hue",
          "dataType": null
        },
        {
          "name": "saturation",
          "dataType": null
        },
        {
          "name": "color",
          "dataType": null
        },
        {
          "name": "colorName",
          "dataType": null
        },
        {
          "name": "RGB",
          "dataType": null
        }
      ]
    },
    "Actuator",
    "ColorTemperature",
    {
      "attributes": [
        {
          "name": "colorTemperature",
          "dataType": null
        },
        {
          "name": "colorName",
          "dataType": null
        }
      ]
    },
    "Light",
    {
      "attributes": [
        {
          "name": "switch",
          "dataType": null
        }
      ]
    },
    "ChangeLevel",
    "ColorMode",
    {
      "attributes": [
        {
          "name": "colorMode",
          "dataType": null
        }
      ]
    }
  ],
  "commands": [
    "configure",
    "off",
    "off",
    "on",
    "on",
    "refresh",
    "setColor",
    "setColorTemperature",
    "setHue",
    "setLevel",
    "setSaturation",
    "startLevelChange",
    "stopLevelChange"
  ]
}