property.current

The property.current command is used to retrieve the current value of a property.

For more information about properties see Defining Properties.

TR50 Request


{
  "cmd": {
    "command": "property.current",
    "params": {
      "thingKey": "mything",
      "key": "myprop",
      "ts": "2015-04-01T12:00:00Z"
    }
  }
}

Request Parameters


Name	Type	Required	Description
	Thing Identifier Parameters		Identifies the thing to which the property data is associated. If omitted, the thingKey associated with your session will be used. See Thing Identifier Parameters table below for supported parameters.
key	String	Yes	The key for the property that you wish to retrieve.
ts	Timestamp		If specified, property.current will return the value at or immediately preceding the specified timestamp.

Thing Identifier Parameters


Name	Type	Description
thingKey	String	Key of the thing
thingId	String	Id of the thing
esn	String	Esn of the thing
iccid	String	Iccid of the thing
imei	String	Imei of the thing
imsi	String	Imsi of the thing
meid	String	Meid of the thing
msisdn	String	Msisdn of the thing

TR50 Response

If the command is sent successfully a success message and the property value are returned. Otherwise, an error and error message will be returned.


{
  "cmd": {
    "success": true,
    "params": {
      "value": 7,
      "ts": "2014-11-17T20:41:45Z",
      "corrId":"xyz"
    }
  }
}

Response Parameters


Name	Type	Description
value	Float	The current value for the requested property.
ts	String	Timestamp for the given value.
corrId	String	The correlation identifier associated with the property.