Subpaas

API calls to interact with Subpaases.

Subdealer (Sub PaaS) actions

IIn Navixy, a Subdealer (Sub PaaS) account is designed for dealers who need to manage multiple accounts that provide services independently. This feature is ideal for dealers who act as larger distributors or service providers. With Sub PaaS accounts, dealers can create and manage additional sub-accounts, each with its own users, devices, and settings.

These sub-accounts function similarly to the main dealer account but allow for more granular control and management. This setup is perfect for servicing other dealers (subdealers) or larger enterprises that require separate PaaS accounts, such as a service run on their own domain. It streamlines operations of multiple independent organizations, while maintaining oversight from the main dealer account.

Subdealer (Sub PaaS) object

{
  "subpaas_id": 18,
  "title": "SubppaasTitle",
  "jur_name": "SubppaasJurName",
  "login": "subpaaslogin",
  "creation_date": "2018-11-15",
  "block_type": "NOT_BLOCKED",
  "users_count": 2,
  "active_users_count": 1,
  "trackers_count": 0,
  "active_trackers_count": 0,
  "contact_fio": "fio",
  "contact_post": "post"
}

• subpaas_id - int. SubPaas id.

• title - string. SubPaas' name.

• jur_name - string. Legal company name.

• creation_date - string. Creation date.

• block_type - enum. Panel and Subpaas' users block status. One of: "NOT_BLOCKED", "INITIAL_BLOCK", "BLOCK_LOGIN" or "CLIENTS_BLOCKED".

• users_count - int. Count of users.

• active_users_count - int. Count of active users.

• trackers_count - int. All devices of SubPaas.

• active_trackers_count - int. Active devices of SubPaas.

• contact_fio - string. Contact person.

• contact_post - string. Contact post (position).

• contact_phone - string. Contact's phone.

API actions

API base path: panel/subpaas.

create

Creates a subPaaS. After creation, its dealer_block_type will be in INITIAL_BLOCK status.

Parameters

name	description	type
password	Subpaas' password.	string
title	Subpaas' name.	string
email	Company email.	string
jur_name	Legal company name.	string
jur_country	Subpaas' country	string
link_monitoring	Subpaas' domain name.	string

Example

cURL

curl -X POST 'https://api.eu.navixy.com/v2/panel/subpaas/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "password": "B1r7d@Y", "title": "Company", "email": "[email protected]", "jur_name": "Company", "jur_country": "Finland", "link_monitoring": "company.com"}'

Response

{
  "success": true
}

Errors

• 13 – If the dealer

  • is not paas.

  • has different status than NOT_BLOCKED.

  • his tariff doesn't allow subpaases.

list

Gets a list of all SubPaaS accounts of a Dealer. Dealer ID will be taken from the session key.

Parameters

name	description	type
order_by	Optional. Sort option. Can be "subpaas_id", "title", "jur_name", "login", "block_type", "creation_date". Default is subpaas_id.	enum
ascending	Optional. If true ordering will be ascending, descending otherwise. Default is true.	boolean
limit	Optional. Pagination. Maximum subpaases to return	int
offset	Optional. Pagination. Get subpaases starting from.	int

Examples

cURL

curl -X POST 'https://api.eu.navixy.com/v2/panel/subpaas/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06"}'

HTTP GET

Response

{
  "success": true,
  "list": [
    {
      "subpaas_id": 18,
      "title": "SubppaasTitle",
      "jur_name": "SubppaasJurName",
      "login": "subpaaslogin",
      "creation_date": "2018-11-15",
      "block_type": "NOT_BLOCKED",
      "users_count": 2,
      "active_users_count": 1,
      "trackers_count": 0,
      "active_trackers_count": 0
    }
  ]
}

• list - array of objects. List of subpaas objects described above.

Errors

• 13 – If the dealer:

  • is not of the PaaS type.

  • has a status other than NOT_BLOCKED.

  • their plan does not allow SubPaaS accounts.

read

Gets Sub PaaS account info by its id.

Parameters

name	description	type
subpaas_id	Subpaas ID.	int

Examples

cURL

curl -X POST 'https://api.eu.navixy.com/v2/panel/subpaas/read' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "subpaas_id": 97834}' 

HTTP GET

Response

{
  "success": true,
  "value": {
    "subpaas_id": 18,
    "block_type": "NOT_BLOCKED",
    "title": "Rus Sub-PaaS",
    "jur_name": "OOO Sub-PaaS",
    "email": "[email protected]",
    "jur_country": "country",
    "link_monitoring": "link",
    "contact_fio": "fio",
    "contact_post": "post",
    "contact_phone": "phone"
  }
}

• value - subpaas object described above.

Errors

• 13 – If the dealer:

  • is not of the PaaS type.

  • has a status other than NOT_BLOCKED.

  • their plan does not allow SubPaaS accounts.

update

Updates a SubPaas account with the specified ID.

Parameters

name	description	type
subpaas_id	Subpaas' ID.	int
password	Subpaas' password.	string
title	Subpaas' name.	string
email	Company email.	string
jur_name	Legal (juristic) company name.	string
jur_country	Subpaas' country	string
link_monitoring	Subpaas' domain name.	string
contact_fio	Contact person.	string
contact_post	Contact post (position).	string
contact_phone	Contact's phone.	string
block_type	Panel and PaaS users block status. One of: "NOT_BLOCKED", "INITIAL_BLOCK", "BLOCK_LOGIN" or "CLIENTS_BLOCKED".	enum

Example

cURL

curl -X POST 'https://api.eu.navixy.com/v2/panel/subpaas/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "password": "B1r7d@Y", "title": "Company", "email": "[email protected]", "jur_name": "Company", "jur_country": "Finland", "link_monitoring": "company.com", "contact_fio": "fio", "contact_post": "CEO", "contact_phone": "79999902190", "block_type": "NOT_BLOCKED"}'

Response

{
  "success": true
}

Errors

• 13 –

  • The dealer is not PaaS.

  • The dealer has a status other than NOT_BLOCKED.

  • SubPaaS accounts are not permitted for the dealer.

  • block_type is DELETED.

  • The found SubPaaS is in DELETED status.

  • The found SubPaaS is not in INITIAL_BLOCK status and block_type is INITIAL_BLOCK.

  • The found SubPaaS is in INITIAL_BLOCK status and block_type is not INITIAL_BLOCK.