Settings actions¶
API base path: /tracker/settings
read¶
Gets base settings for the specified tracker.
parameters¶
name | description | type | format |
---|---|---|---|
tracker_id | Id of the tracker (aka "object_id"). Tracker must belong to authorized user and not be blocked. | int | 123456 |
examples¶
curl -X POST 'https://api.navixy.com/v2/fsm/tracker/settings' \
-H 'Content-Type: application/json' \
-d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": "123456"}'
https://api.navixy.com/v2/fsm/tracker/settings?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=123456
response¶
{
"success": true,
"settings": {
"label": "Courier",
"group_id": 1
}
}
label
- string. User-defined label for this tracker, e.g. "Courier".group_id
- int. Tracker group id. 0 if tracker does not belong to any group.
errors¶
- 201 – Not found in the database (if there is no tracker with such id belonging to authorized user).
- 208 – Device blocked (if tracker exists but was blocked due to tariff restrictions or some other reason).
update¶
Updates the settings of the specified tracker.
required sub-user rights: tracker_update
parameters¶
name | description | type | format |
---|---|---|---|
tracker_id | Id of the tracker (aka "object_id"). Tracker must belong to authorized user and not be blocked. | int | 123456 |
group_id | Tracker group id. 0 if tracker does not belong to any group. The specified group must exist. | int | 1 |
label | User-defined label for this tracker, e.g. "Courier". Must consist of printable characters and have length between 1 and 60. Cannot contain < and > symbols. | string | "Courier" |
examples¶
curl -X POST 'https://api.navixy.com/v2/fsm/tracker/update' \
-H 'Content-Type: application/json' \
-d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": "123456", "group_id": "1", "label": "Courier"}'
https://api.navixy.com/v2/fsm/tracker/update?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=123456&group_id=1&label=Courier
response¶
{ "success": true }
errors¶
- 201 – Not found in the database (if there is no tracker with such id belonging to authorized user).
- 208 – Device blocked (if tracker exists but was blocked due to tariff restrictions or some other reason).
- 204 – Entity not found (if there is no group with the specified group id).
Last update: October 23, 2020