Skip to content

Subpaas actions

API calls to interact with Subpaases.


Subpaas 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 (juristic) 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 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 (juristic) company name. string
jur_country Subpaas' country string
link_monitoring Subpaas' domain name. string

example

curl -X POST 'https://api.navixy.com/v2/panel/subpaas/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "password": "B1r7d@Y", "title": "Company", "email": "email@company.com", "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 subpaases for 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 -X POST 'https://api.navixy.com/v2/panel/subpaas/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06"}'
https://api.navixy.com/v2/panel/subpaas/list?hash=fa7bf873fab9333144e171372a321b06

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
    }
  ]
}

errors

  • 13 – If the dealer
    • is not paas.
    • has different status than NOT_BLOCKED.
    • his tariff doesn't allow subpaases.

read

Gets subpaas info by its id.

parameters

name description type
subpaas_id Subpaas ID. int

examples

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

response

{
  "success": true,
  "value": {
    "subpaas_id": 18,
    "block_type": "NOT_BLOCKED",
    "title": "Rus Sub-PaaS",
    "jur_name": "OOO Sub-PaaS",
    "email": "sub-dealer@email.com",
    "jur_country": "country",
    "link_monitoring": "link",
    "contact_fio": "fio",
    "contact_post": "post",
    "contact_phone": "phone"
  }
}

errors

  • 13 – If the dealer
    • is not paas.
    • has different status than NOT_BLOCKED.
    • his tariff doesn't allow subpaases.

update

Updates a subpaas with 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 -X POST 'https://api.navixy.com/v2/panel/subpaas/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "password": "B1r7d@Y", "title": "Company", "email": "email@company.com", "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 different status than NOT_BLOCKED.
    • Subpaases are not permitted for dealer.
    • block_type is DELETED.
    • Found subpaas is in DELETED status.
    • Found subpaas is not in INITIAL_BLOCK status and block_type is INITIAL_BLOCK.
    • Found subpaas is in INITIAL_BLOCK status and block_type is not INITIAL_BLOCK.

Last update: December 26, 2022