Versions Compared

Version Old Version 10 New Version Current
Changes made by

Bart Friederichs

Bart Friederichs

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
WIll only work if cabinet is in mode

tag

. Refer to Cabinet to set cabinet in the correct mode

.

controllerno is a number, tagno tagid is an PTL ident (in the case of ATOP, this is also a number).

URL

http://<<ip address>>/rest/controller/«controllerno»/tag/«tagno»«tagid»

Method

GET

Description

Receives information of a tag.

Note
Info

For the standardised PTL cabinet, controller 1 is the front, controller 2 is the back. Tag IDs are numbered from 11 upwards (left-to-right, bottom-to-top).

Response

Code Block
languagejson
{
  "value": «lastdisplayedvalue»,
  "state": «state»
}

Possible Error

HTTP404 with no body when controller does not exist

Note when the cabinet sides setting is set to frontonly, controller 2 will not be available and this will result in an HTTP404.

Status

StatuscolourGreentitleimplemented

controllerno is a number, tagno tagid is an PTL ident (in the case of ATOP, this is also a number).

URL

http://<<ip address>>/rest/controller/«controllerno»/tag/«tagno»«tagid»

Method

PUT

Description

Sets value and color on a tag.

note

WIll only work if cabinet in de in mode tag. Refer to Cabinet to set cabinet in the correct mode.

Info

For the standardised PTL cabinet, controller 1 is the front, controller 2 is the back. Tag IDs are numbered from 11 upwards (left-to-right, bottom-to-top).

Request

Code Block
languagejson
{
  "value": «valuetodisplay»,
  ["color": "red|green|orange|blue|pink|cyan|none"],
  ["blinking": "on|off|blink2sec|blink1sec|blink05sec|blink025sec"]
}

value should be a string, if value is null, the tag is switched off.

color is optional. When no color is chosen, it defaults to red.

value blinking should be a string, if value is null, the tag is switched off.it defaults to on(i.e. no blinking). off causes the LED to switch off (identical to "color": "none")

Response

HTTP204 when successful

Possible Errors

HTTP400 when request was invalid

Code Block
{
  "message": «human readable error»
}

HTTP404 with no body when controller does not existHTTP409 when cabinet not in correct mode

Note when the cabinet sides setting is set to frontonly, controller 2 will not be available and this will result in an HTTP404.

Status

Status
colourGreen
titleimplemented

Remarks

v2.2:

  • Blinking support added.

pending

URL

http://<<ip address>>/rest/controller/«controllerno»/tag/

Method

PUT

Description

Sets value and color on a range of tags.

controllerno is a number

Info

For the standardised PTL cabinet, controller 1 is the front, controller 2 is the back. Tag IDs are numbered from 11 upwards (left-to-right, bottom-to-top).

Request

Code Block
languagejson
[
  {
    "tagtagid": «tagno»«tagid»,
    "value": «valuetodisplay»,
    ["color": "red|green|orange|blue|pink|cyan|none"],
    ["blinking": "on|off|blink2sec|blink1sec|blink05sec|blink025sec"]
  },
  ...
]

value should be a string, when set to null the tag is switched off (v2.1.2+).

color is optional. When no color is chosen, it defaults to red.

value blinking should be a string, if value is null, the tag is switched off.it defaults to on(i.e. no blinking). off causes the LED to switch off (identical to "color": "none")

Response

HTTP204 when successful

Possible Errors

HTTP400 when request was invalid

Code Block
{
  "message": «human readable error»
}

HTTP404 with no body when controller does not exist

HTTP409 when cabinet not in correct mode

Note when the cabinet sides setting is set to frontonly, controller 2 will not be available and this will result in an HTTP404.

Status

Status
colourYellow
title

Remarks

v2.2:

  • Blinking support added.

v2.1.2:

  • Tags are no longer switched off before setting the tag range. (You can handle the switching off of tags by yourself, using the cabinet/lightest call. When used with off, this switches off all lights).

v2.1.1:

  • All tags are switched off before the range is set, this means sending [] causes all tags to be switched off.

v2.1:

  • Tag range call added