Files

Device Cloud stores files associated with a specific thing or associated with the organization of the thing (global).

Files identifiers are retrieved from Device Cloud using the file.put command and the file.get command. The file is then uploaded to Device Cloud using an HTTP POST command or retrieved from Device Cloud using an HTTP GET command. For more information about the commands, see file.put and file.get.

Tags are associated with files to help with filtering on the file display pages and have security tags associated with them to restrict access.

Access to files can be restricted to users and applications in the same the organization or allow access by users and applications in other organizations (public). 

// file.put command is called:
{
  "cmd": {
    "command": "file.put",
    "params": {
      "fileName": "test_results.xls"
    }
  }
}

// file.put result:
{
  "cmd": {
    "success": true,
    "params": {devicecloud
      "fileId": "50000000000000000000042"
    }
  }
}

// Upload the file to Device Cloud through an HTTP POST in your programming environment. An example using curl is:
curl -x POST --data-binary @test_results.xls http://api.devicewise.com/file/50000000000000000000042 

// file.get command is called:
{
  "cmd": {
    "command": "file.get",
    "params": {
      "fileName": "test_results.xls",
      "global": true
    }
  }
}

// file.get result:
{
  "cmd": {
    "success": true,
    "params": {
      "fileId": "50000000000000000000042",
      "fileSize": 2824
    }
  }
}

// Download the file from Device Cloud via an HTTP GET in your programming environment. An example using curl is:
curl -o test_results.xls http://api.helixdevicecloud.com/file/50000000000000000000042