Retranslator¶
Contains tracker retranslator binding object and API calls to bind/unbind it to tracker or get already binded one.
Tracker retranslator binding object¶
{
"retranslator_id": 4548,
"fake_device_id": "AI568T"
}
retranslator_id
- int. An ID of the retranslator.fake_device_id
- string. Optional. If this field is set retranslator use it instead of real device ID to forward data.
API actions¶
API base path: /tracker/retranslator
.
bind
¶
Creates or updates binding.
required sub-user rights: admin
(available only to master users).
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 | 999199 |
retranslator_id | Retranslator ID. | int | 123 |
fake_device_id | Optional. If set the retranslator will use this value instead of real device ID to forward data. | string | "AI568T" |
Examples¶
curl -X POST 'https://api.navixy.com/v2/tracker/retranslator/bind' \
-H 'Content-Type: application/json' \
-d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "tracker_id": 265489, "retranslator_id": 123}'
https://api.navixy.com/v2/tracker/retranslator/bind?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=265489&retranslator_id=123
Response¶
{ "success": true }
Errors¶
- 201 - Not found - either tracker or retranslator are not found by provided ID
- 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions or some other reason.
- 219 - Not allowed for clones of the device – if tracker is a clone.
- 236 - Feature unavailable due to tariff restrictions – if there are no trackers with "retranslation" tariff feature available.
- 242 - There were errors during content validation – if
fake_device_id
is invalid for the retranslator protocol.
list
¶
List tracker retranslators bound to tracker with ID=tracker_id
.
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 | 999199 |
Examples¶
curl -X POST 'https://api.navixy.com/v2/tracker/retranslator/list' \
-H 'Content-Type: application/json' \
-d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "tracker_id": 265489}'
https://api.navixy.com/v2/tracker/retranslator/list?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=265489
Response¶
{
"success": true,
"list": [{
"retranslator_id": 4548,
"fake_device_id": "AI568T"
}]
}
Errors¶
- 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions, or some other reason.
unbind
¶
Unbinds a tracker from retranslator.
required sub-user rights: admin
(available only to master users).
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 | 999199 |
retranslator_id | Retranslator ID. | int | 123 |
Examples¶
curl -X POST 'https://api.navixy.com/v2/tracker/retranslator/unbind' \
-H 'Content-Type: application/json' \
-d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "tracker_id": 265489, "retranslator_id": 123}'
https://api.navixy.com/v2/tracker/retranslator/unbind?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=265489&retranslator_id=123
Response¶
{ "success": true }
Errors¶
- 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions, or some other reason.
- 219 - Not allowed for clones of the device – if tracker is a clone.
Last update: October 16, 2024