Devices

/devices?key=value&key=value

Returns an array of device UUIDs based on key/value query criteria

Shell

coap get -H "meshblu_auth_uuid={:UUID}&meshblu_auth_token={:TOKEN}" coap://meshblu-coap.octoblu.com/devices?type=drone

JSON

{"devices":["ad698900-2546-11e3-87fb-c560cb0ca47b","2f3113d0-2796-11e3-95ef-e3081976e170"]}

/devices/{uuid}

Returns all information (except the token) of a specific device or node

Shell

coap get -H "meshblu_auth_uuid={:UUID}&meshblu_auth_token={:TOKEN}" coap://meshblu-coap.octoblu.com/devices/ad698900-2546-11e3-87fb-c560cb0ca47b

JSON

{"_id":"5241d9140345450000000001","api":"update","armed":true,"channel":"main","deviceDescription":"this is a test","deviceName":"hackboard","key":"777","online":true,"socketid":"fO8dxKEwARUH9Ea- -p2C","timestamp":1381536277933,"uuid":"ad698900-2546-11e3-87fb-c560cb0ca47b"}

/devices

Registers a node or device with Meshblu. Meshblu returns a UUID device id and security token. You can pass any key/value pairs and even override Meshblu's auto-generated UUID and/or token by passing your own uuid and/or token in the payload i.e. uuid=123&token=456

Shell

coap post -p "type=drone&color=black" -H "meshblu_auth_uuid={:UUID}&meshblu_auth_token={:TOKEN}" coap://meshblu-coap.octoblu.com/devices

📘

Payload: key=value (i.e. type=drone&color=black)

JSON

{"type":"drone","color":"black","uuid":"6f72bc60-32d5-11e3-92e2-e94f95fc16a6","timestamp":1381537803046,"token":"4bbd2jm242dl5wmimbwz4rvlu77m0a4i","channel":"main","online":false,"_id":"5258980b56330f7dd000000d"}

/devices/{uuid}

Updates a node or device currently registered with Meshblu. You must pass the token for security but you can pass any key/value pairs to update object as well as null to remove a propery (i.e. color=null).

Shell

coap put -p "token=123&color=blue&online=true" -H "meshblu_auth_uuid={:UUID}&meshblu_auth_token={:TOKEN}" coap://meshblu-coap.octoblu.com/devices/ad698900-2546-11e3-87fb-c560cb0ca47b

📘

Payload: token=123&key=value (i.e. token=123&type=drone&color=blue&online=true)

JSON

{"uuid":"ad698900-2546-11e3-87fb-c560cb0ca47b","color":"blue","timestamp":1381537750462}

/devices/{uuid}

Deletes or unregisters a node or device currently registered with Meshblu. You must pass the token for security.

Shell

coap delete -p "token=123" -H "meshblu_auth_uuid={:UUID}&meshblu_auth_token={:TOKEN}" coap://meshblu-coap.octoblu.com/devices/ad698900-2546-11e3-87fb-c560cb0ca47b

📘

Payload: token=123

JSON

{"uuid":"ad698900-2546-11e3-87fb-c560cb0ca47b","timestamp":1381537971074}