Home Screens Reporters

REST API

Update tag

POST
https://api.realtime.report/v1/tags

Authentication: API Key

Update a tag with a new value.

Parameters

device_id
INTEGER
Set the device of the tag. (required)

Response

Returns data of the tag

201
application/json; charset=utf-8
id
String
The id of the tag
name
String
The name of the tag
is_setpoint
Bool
True if this is a setpoint and false if we have only read access.
is_alarm
Bool
True if this is an alarm and false if we have only read access.
value
Variable
The current value of this tag.

Example


/*
* Example get tag - How to get tag information from the  API
* https://api.realtime.report/v1/tags
*/
try {

	/*
    * Initialize the RealtimeReporter API SDK with your API key.
    * See: https://realtime.report/developer
    */
	require_once $_SERVER['DOCUMENT_ROOT'].'/vendor/autoload.php';

	$reporter = new reporter_api ;
    $reporter->set_api_key('YOUR API KEY');

    /*
	* Set the new value 
	*/

    $data = array();
    $data['device_id'] = 3244 ;
    $data['value'] = 90 ;

	/*
	* Update the tag value
	*/
    $tag = $reporter->update_tag('tag_id', $data);

    /*
    * In this example we print the data in json format on the page
    */
    echo "Tag data";
    echo json_encode($tag, JSON_PRETTY_PRINT);


} catch (Exception $e) {
    echo "API call failed: " . htmlspecialchars($e->getMessage());
}

Response example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "id": "82449b8e92eb4f678707",
    "name": "Valve open",
    "is_setpoint": true,
    "is_alarm": false,
    "value": 90
}

Response Error

Returns an array with error information

230
application/json; charset=utf-8
code
Integer
The error code listed in a list below
message
String
The error message listed in a list below

Error Codes

1000
No valid API key
1001
No tag found
1001
No device found