HTTP Device Read


Request


GET https://api.flowthings.io/v0.1/<account_id>/device/<device_id>?refs=<refs>

Params

  • refs - Adds objects related to the devices retrieved by the find to the response head. By default references are off (0). Turning references on (1) will add the Devices' Tokens and Flows to the response head, keyed by id.

Headers

NameDescription
Content-Typeapplication/json
X-Auth-TokenAuthentication Token

Response


HTTP Codes

CodeDescription
200Resource Found
400Bad Request
401Unauthorized
503Service Unavailable

Example Response Body

{
  "head": {
    "status": 200,
    "ok": true,
    "messages": [
      "Your request has been processed successfully."
    ],
    "errors": []
  },
  "body": {
    "id": "d5489f22ed4c66f8dfcbe2794",
    "creationDate": 1409455732680,
    "displayName": "Thermostat",
    "path" : "/alice/devices/home/thermostat",
    "token" : "k548b20f2d4c63c0634ad3cc8",
    "status" : "UNSEEN",
    "reportPeriodicity" : 60000
  }
}