Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 8 Next »

Cabinet

URL

http://<<ip address>>/rest/cabinet

Method

GET

Description

Receives information on the cabinet.

Response

{ 
  "planks": «numberofplanks», 
  "sections": «numberofsections»
}

Status

IMPLEMENTED

Change

PENDING

Add name and status:

{
  "planks": «numberofplanks», 
  "sections": «numberofsections»,
  "name": «nameofcabinet»,
  "status": [«listofhumanreadablestatusmessages»]
}

Status message can be:

  • Tag N missing

  • Controller communication error

When list of messages is empty, cabinet is “OK”.

URL

http://<<ip address>>/rest/cabinet

Method

PUT

Description

Stores information on the cabinet.

Request

{ 
  "planks": «numberofplanks», 
  "sections": «numberofsections» 
}

Response

HTTP204 when successful

Possible Errors

HTTP400 when request was invalid

{
  "message": «human readable error»
}

Status

IMPLEMENTED

Change

PENDING

Add name:

{
  "planks": «numberofplanks», 
  "sections": «numberofsections»,
  "name": «nameofcabinet»
}

URL

http://<<ip address>>/rest/cabinet/lighttest

Method

PUT

Description

Sets the cabinet is lighttest mode: turning light on or off

Request

{ 
  "mode": "on" | "off"
}

Response

HTTP204 when successful

Possible Errors

HTTP400 when request was invalid

{
  "message": «human readable error»
}

Status

PENDING

URL

http://<<ip address>>/rest/cabinet/teach

Method

PUT

Description

Sets the cabinet in or out of teach mode.

Request

{ 
  "mode": "on" | "off"
}

Response

HTTP204 when successful

Possible Errors

HTTP400 when request was invalid

{
  "message": «human readable error»
}

Status

PENDING

URL

http://<<ip address>>/rest/cabinet/teach

Method

GET

Description

Get current state of teach mode

Responses

HTTP204 when not in teach mode

HTTP200 when in teach mode, with following body:

{
  "tag": [«list of tags found»]
}

Status

PENDING

Section

Plank and section numbering is 1-based. So if 4 planks are available, they are numbered 1 to 4.

URL

http://<<ip address>>/rest/plank/«plankno»/section/«sectionno»

Method

GET

Description

Receives information of section.

Response

{
  "value": «lastdisplayedvalue»,
  "state": «state»
}

Possible Error

HTTP404 with no body when section does not exist.

Status

IMPLEMENTED

URL

http://<<ip address>>/rest/plank/«plankno»/section/«sectionno»

Method

PUT

Description

Sets value on display.

Request

{
  "value": «valuetodisplay»
}

Response

HTTP204 when successful

Possible Errors

HTTP400 when request was invalid

{
  "message": «human readable error»
}

HTTP404 with no body when section does not exist

Status

IMPLEMENTED

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.