Retranslator¶

API path: /retranslator.

CRUD actions for retranslators.

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¶

create¶

Creates new retranslator.

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

parameters¶

examples¶

curl -X POST 'https://api.navixy.com/v2/fsm/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¶

examples¶

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

https://api.navixy.com/v2/fsm/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/fsm/retranslator/list' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b"}'

https://api.navixy.com/v2/fsm/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¶

examples¶

curl -X POST 'https://api.navixy.com/v2/fsm/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.

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

https://api.navixy.com/v2/fsm/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.