Skip to content

Retranslator

Retranslator and retranslator protocol objects and CRUD actions for retranslators. They can be used to redirect the data that comes from a device to the platform to some third-party application specified by the user.


Retranslator protocol object

{
    "id": 123456,
    "name": "protocol",
    "has_login": true,
    "has_password": false,
    "fake_device_id_pattern": "id_pattern",
    "required_login": true,
    "required_password": false
}
  • id - int. Protocol ID.
  • name - string. Protocol name.
  • has_login - boolean. true if this protocol use login.
  • has_password - boolean. true if this protocol use password.
  • fake_device_id_pattern - optional string. Regex pattern for fake_device_id validation.
  • required_login - boolean. true if for this protocol login required.
  • required_password - boolean. true if for this protocol password required.

Retranslator object

{
    "id": 1,
    "name": "Some server",
    "protocol_id": 123456,
    "address": "127.0.0.1",
    "port": 15000,
    "login": "login",
    "password": "password",
    "enabled": true
}
  • id - int. Retranslator ID.
  • name - string. Zone label.
  • protocol_id - int. Protocol ID.
  • address - string. Network address, e.g. 127.0.0.1 or localhost.
  • port - int. Port number.
  • login - optional string.
  • password - optional string.
  • enabled - boolean. Status.

API actions

API path: /retranslator.

create

Creates new retranslator.

required sub-user rights: admin (available only to master users).

parameters

name description type
retranslator Retranslator object without id field. JSON object

example

curl -X POST 'https://api.navixy.com/v2/retranslator/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "retranslator": {"name": "Some server", "protocol_id": 123456, "address": "127.0.0.1", "port": 15000, "login": "proto", "password": "qewtyr", "enabled": true}}'

response

{
    "success": true,
    "id": 123456
}
  • id - int. ID of the created retranslator.

errors

  • 247 - Entity already exists - if retranslator with this address, port and login already exists.
  • 7 - Invalid parameters - if retranslator have required fields (login or password), but was send empty.
  • 268 - Over quota – if the user's quota for retranslators exceeded.

delete

Deletes user's retranslator with specified retranslator_id.

required sub-user rights: admin (available only to master users).

parameters

name description type format
retranslator_id ID of the retranslator that will be deleted. int 123456

examples

curl -X POST 'https://api.navixy.com/v2/retranslator/delete' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "retranslator_id": 123456}'
https://api.navixy.com/v2/retranslator/delete?hash=a6aa75587e5c59c32d347da438505fc3&retranslator_id=123456

response

{ "success": true }

errors

  • 201 - Not found in the database.

list

Get all users' retranslators.

examples

curl -X POST 'https://api.navixy.com/v2/retranslator/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b"}'
https://api.navixy.com/v2/retranslator/list?hash=a6aa75587e5c59c32d347da438505fc3

response

{
    "success": true,
    "list": [{
      "id": 1,
      "name": "Some server",
      "protocol_id": 123456,
      "address": "127.0.0.1",
      "port": 15000,
      "login": "login",
      "password": "password",
      "enabled": true
    }]
}
  • id - int. Retranslator ID.
  • name - string. Zone label.
  • protocol_id - int. Protocol ID.
  • address - string. Network address, e.g. 127.0.0.1 or localhost.
  • port - int. Port number.
  • login - optional string.
  • password - optional string.
  • enabled - boolean. Status.

update

Updates retranslator parameters for the specified retranslator. Note that retranslator must exist, and must belong to the current user.

required sub-user rights: admin (available only to master users).

parameters

name description type
retranslator Retranslator object without id field. JSON object

example

curl -X POST 'https://api.navixy.com/v2/retranslator/update' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "retranslator": {"name": "Some server", "protocol_id": 123456, "address": "127.0.0.1", "port": 15000, "login": "proto", "password": "qewtyr", "enabled": true}}'

response

{ "success": true }

errors

  • 201 - Not found in the database – if retranslator with the specified ID cannot be found or belongs to another user.
  • 247 - Entity already exists – if retranslator with this address, port and login already exists.

protocols list

Returns all available retranslator protocols.

parameters

Only API key hash.

examples

curl -X POST 'https://api.navixy.com/v2/retranslator/protocol/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b"}'
https://api.navixy.com/v2/retranslator/protocol/list?hash=a6aa75587e5c59c32d347da438505fc3

response

{
    "success": true,
    "list": [{
      "id": 123456,
      "name": "protocol",
      "has_login": true,
      "has_password": false,
      "fake_device_id_pattern": "id_pattern",
      "required_login": true,
      "required_password": false
    }]
}
  • id - int. Protocol ID.
  • name - string. Protocol name.
  • has_login - boolean. true if this protocol use login.
  • has_password - boolean. true if this protocol use password.
  • fake_device_id_pattern - optional string. Regex pattern for fake_device_id validation.
  • required_login - boolean. true if for this protocol login required.
  • required_password - boolean. true if for this protocol password required.

Last update: December 26, 2022