App Profiles

An App Profile instance resource represents a single app profile entity.

Resource Attributes

AttributeDescription
idA 23 to 26 characters long string that uniquely identifies this app profile.
accountIdThe unique id of the account that created this app profile.
nameAccount wide unique, URL friendly name of the app profile.
friendlyNameHuman friendly name of the app profile.
baseProfileIdThe id of the base app profile, if any.
descriptionOptional. A brief about this app profile.
tagsOptional. Tags associated with this app profile.
versionOptional. The version of this app profile.
productNameOptional. The product name, if any.
vendorNameOptional. The vendor of the app profile.
imageUrlOptional. URL for the device image.
systemThe device system this app profile will be working with. [] means all types.
lockedLocked app profile cannot be deleted, modified, new sub resources (e.g. properties) cannot be added, or existing sub resources cannot be removed; but unless they are locked individually, sub resources can be modified.
dateCreatedThe date that this app profile was created in ISO 8601 format.
dateModifiedThe date that this app profile entity was modified in ISO 8601 format.
{
  "id": "_apf_873053802870285130",
  "accountId": "_acc_873046106083527769",
  "name": "Vending_Machine",
  "friendlyName": "Vending Machine Monitoring",
  "description": "My demo vending machine monitoring app",
  "tags": [
    "test"
  ],
  "version": "1.0",
  "vendorName": "Acme co.",
  "productName": "VendingMac Monitor",
  "system": [
    {
      "deviceProfileId": "_dpf_873048732840926433",
      "cardinality": 2
    }
  ],
  "locked": false,
  "dateCreated": "2017-04-19T14:02:03.579Z",
  "dateModified": "2017-04-19T14:02:03.579Z"
}

System Object

It defines the device system that this app profile will be working with. It makes this definition in term of device profile types and their unit cardinalities. For example, you can create an app profile to remotely monitor vending machines and define a system with 1 temperature sensor, 1 humidity sensor and 1 voltage meter. All apps generated from this profile are bound to this system.

AttributeDescription
deviceProfileIdId of the device profile.
cardinalityThe maximum number of units of this device profile that can be incorporated into this system. It should be a positive integer number or -1 to denote multiple.