REST API

Documentation for the plugin's API, which can be used to create custom controls etc. in other services.

The plugin implements a SimpleAPI as provided by OctoPrint, which enables external access to the plugin's functionality.

It has a single endpoint, supporting a get request and posting a command.

SimpleAPI Get

GET http://octopi.local/api/plugin/ws281x_led_status

Get current state of the plugin, which includes the light status and the torch status.

Headers

NameTypeDescription

X-Api-Key*

string

A valid OctoPrint API key.

{
  "lights_on": false,
  "torch_on": false
}

SimpleAPI Command

POST http://octopi.local/api/plugin/ws281x_led_status

Send commands to the plugin, to make it do something.

Headers

NameTypeDescription

X-Api-Key*

string

A valid OctoPrint API key

Request Body

NameTypeDescription

command*

string

The command to be sent to the plugin. See commands below.

{
  "lights_on": false,
  "torch_on": false
}

See also the OctoPrint SimpleApi docs for details about how the request should be structured.

Commands

CommandParametersExplanation

lights_on

None

Turn the LEDs on

lights_off

None

Turn the LEDs off

lights_toggle

None

Toggle the LED state

torch_on

None

Turn the torch mode on

torch_off

None

Turn the torch mode off. Only available if torch mode is configured as toggle.

test_os_config

None

Begin an OS configuration test. Asynchronous, data is returned on the socket

test_led

color

Set the LEDs to the configured HTML RGB colour, color should be a full 7 character hex (eg. #ff00ff)

Last updated