Website API

Description

Website implements an API which allows chaning the color or the publicly available device via HTTP GET request. The request has to be formatted in the following way:

http://www.blinkstick.com/d/public_code/color[.json]

Parameters

The first part of the request http://www.blinkstick.com/d/public_code is the public URL for the device available in the device details page.

"color" parameter can be:

  • Hex color value (for example ff0000, ce5905, ffffff)
  • Named CSS color (for example red, green, blue, orange)

The suffix .json is optional and would return "ok" when color was changed or error message if color value is invalid. If suffix is ommited, the website will generate HTML page for the public BlinkStick page.

Examples

You can use any web browser to send a reques, curl utility on Unix operating systems or any other application that supports sending HTTP requests.

Set red color:

curl http://www.blinkstick.com/d/12345678/red.json

Set blue color:

curl http://www.blinkstick.com/d/12345678/blue.json

Set hexadecimal #550190 color:

curl http://www.blinkstick.com/d/12345678/550190.json