A lookup call to get all available illumination types, including their ID and description. The call will allow a single ID to be supplied in order to return the description. If no ID is supplied, all illumination types are returned.
When accessed via a GET request this API method will return a list of all illumination types. By specifying an id parameter you can retrieve details about a specific illumination.
As this method is accessed via a GET request there is no HTTP body so options can be specified via the URL.
id (optional) - string - a illumination code to restrict results to.
If accessing GET /api/illumination?id=2 the following JSON would be returned:
{
"data": [
{
"id": "2",
"description": "Illuminated (front)"
}
]
}
A "data" element that contains an array of illuminations defined as follows:
id - string - the unique identifier used within SPACE to reference the illumination
description - string - a description of the illumination suitable for display to a user