Service Settings¶

Service settings in Navixy allow administrators to configure and customize various aspects of the monitoring service. These settings control the appearance and functionality of the platform, such as default maps, user interfaces, branding elements, and user registration options. By adjusting these parameters, administrators can tailor the platform to better meet the needs of their users and reflect their company's branding and operational requirements.

Service settings object¶

Let's explore the Service Settings object using the following example:

{
    "service_title": "monitoring service",
    "locale": "en_US",
    "demo_login": "demo",
    "demo_password": "demo",
    "maps": ["osm", "wikimapia", "yandexpublic", "osmmapnik"],
    "default_map": {
      "type": "osm",
      "location": {
        "lat": 33.0, 
        "lng": 22.0
      },
      "zoom": 2
    },
    "currency": "EUR",
    "payment_link": "http://payme.ru",
    "promo_url": "http://monitoring.com/about",
    "google_client_id": "io54p54ijy54",
    "domain": "track.agent.com",
    "favicon": "http://test.com/favicon.ico",
    "app_logo": "paas/5001/app_logo.png",
    "logo": "paas/5001/logo.png",
    "document_logo": "paas/5001/document_logo.png",
    "login_wallpaper": "paas/5001/login.png",
    "desktop_wallpaper": "http://test.com/test.jpg",
    "login_footer": "All rights reserved.",
    "allow_registration": true,
    "show_mobile_apps": true,
    "default_user_settings": {
      "geocoder": "google",
      "route_provider": "progorod",
      "measurement_system": "metric",
      "translit": false
    },
    "display_model_features_link": false,
    "limited_domain": false,
    "allowed_maps": ["osm", "wikimapia", "yandexpublic", "osmmapnik"],
    "color_theme": "aqua",
    "app_color_theme": "blue_1",
    "privacy_policy_link": "http://privacy-policy-url",
    "tos": "Terms Of Service text",
    "no_register_commands": false,
    "default_user_time_zone": "Europe/London"
}

• service_title - string. Name of the service.
• locale - enum. Default locale of the dealer.
• demo_login - string. Login used for demo authorization if not empty.
• demo_password - string. Password used for demo authorization if not empty.
• maps - enum array. Maps available in the monitoring system. Only free maps are available if the domain is the platform owner's subdomain.
• default_map - Default map settings object.
  • type - enum. Default map code.
  • location - Location object. Default location to show on the map when monitoring opens. Described in the data types description section.
  • zoom - int. Default zoom level to use.
• currency - enum. Currency code shown in the UI.
• payment_link - string. Link to the dealer's payment system. Can be null or empty.
• promo_url - string. Customizable "About company" URL. Can be null or empty.
• google_client_id - string. Google Maps client ID (not supported by the interface yet).
• domain - string. Domain used for the monitoring system.
• favicon - string. Path or URL to the dealer's interface favicon. Nullable.
• app_logo - string. Path or URL to the dealer's mobile app logotype. Nullable.
• logo - string. Path or URL to the dealer's logotype. Nullable.
• document_logo - string. Path or URL to the dealer's logotype for documents. Nullable.
• login_wallpaper - string. Path or URL to the dealer's interface login wallpaper. Nullable.
• desktop_wallpaper - string. Path to the dealer's interface wallpaper. Nullable.
• login_footer - string. Footer included on the login page. Nullable.
• allow_registration - boolean. Allows self-registration of users if true.
• show_mobile_apps - boolean. Prompts users to download the mobile app or continue using the mobile web UI when entering the service from a mobile device or tablet if true.
• default_user_settings - Default user settings object.
  • geocoder - string. Default geocoder.
  • route_provider - string. Default route provider.
  • measurement_system - enum. Measurement system.
  • date_format - Optional enum. Date representation.
  • hour_mode - Optional enum. Time representation.
  • translit - boolean. SMS transliteration. Reduces the number of characters in an SMS by replacing the characters of the national alphabet with close Latin ones if true.
• display_model_features_link - boolean. Shows a link to navixy.com in model info if true (UI option).
• limited_domain - boolean. Indicates whether the PaaS domain has limitations if true.
• allowed_maps - enum. List of maps available for selection in the "maps" list.
• color_theme - string. Max 128 characters. Color theme code or empty string (for the default theme).
• app_color_theme - string. Max 128 characters. Mobile app color theme code or empty string (for the default theme).
• privacy_policy_link - string. Nullable, privacy policy link (it may be empty).
• tos - string. Nullable, terms of service text (it may be empty).
• no_register_commands - boolean. Prevents sending commands to devices on activation if true.
• default_user_time_zone - string. Time zone ID for new users created via user/upload. This time zone is also selected by default when creating a new user in the Navixy Admin Panel.

API actions¶

API path: panel/dealer/settings/service.

read¶

Gets current monitoring service settings.

required permissions: service_settings: "read".

Parameters¶

Only session hash.

Examples¶

curl -X POST 'https://api.navixy.com/v2/panel/dealer/settings/service/read' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06"}'

https://api.navixy.com/v2/panel/dealer/settings/service/read?hash=fa7bf873fab9333144e171372a321b06

Response¶

{
  "success": true,
  "value": {
       "service_title": "monitoring service",
       "locale": "en_US",
       "demo_login": "demo",
       "demo_password": "demo",
       "maps": ["osm", "wikimapia", "yandexpublic", "osmmapnik"],
       "default_map": {
         "type": "osm",
         "location": {
           "lat": 33.0, 
           "lng": 22.0
         },
         "zoom": 2
       },
       "currency": "EUR",
       "payment_link": "http://payme.ru",
       "promo_url": "http://monitoring.com/about",
       "google_client_id": "io54p54ijy54",
       "domain": "track.agent.com",
       "favicon": "http://test.com/favicon.ico",
       "app_logo": "paas/5001/app_logo.png",
       "logo": "paas/5001/logo.png",
       "document_logo": "paas/5001/document_logo.png",
       "login_wallpaper": "paas/5001/login.png",
       "desktop_wallpaper": "http://test.com/test.jpg",
       "login_footer": "All rights reserved.",
       "allow_registration": true,
       "show_mobile_apps": true,
       "default_user_settings": {
         "geocoder": "google",
         "route_provider": "progorod",
         "measurement_system": "metric",
         "translit": false
       },
       "display_model_features_link": false,
       "limited_domain": false,
       "allowed_maps": ["osm", "wikimapia", "yandexpublic", "osmmapnik"],
       "color_theme": "aqua",
       "app_color_theme": "blue_1",
       "privacy_policy_link": "http://privacy-policy-url",
       "tos": "Terms Of Service text",
       "no_register_commands": false,
       "default_user_time_zone": "America/New_York"
  }
}

• value - Service settings object described above.

Errors¶

General types only.

update¶

Updates monitoring service settings for the current dealer.

Note: wallpapers, logos and favicons cannot be edited here.

required permissions: service_settings: "update".

Parameters¶

Example¶

curl -X POST 'https://api.navixy.com/v2/panel/dealer/settings/notification/update' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "service_title": "monitoring service", "locale": "en_US", "demo_login": "demo", "demo_password": "demo", "maps": ["osm", "wikimapia", "yandexpublic", "osmmapnik"], "default_map": {"type": "osm", "location": {"lat": 33.0, "lng": 22.0}, "zoom": 2}, "currency": "EUR", "payment_link": "http://payme.ru", "promo_url": "http://monitoring.com/about", "google_client_id": "io54p54ijy54", "domain": "track.agent.com", "login_footer": "All rights reserved.", "allow_registration": true, "show_mobile_apps": true, "default_user_settings": {"geocoder": "google", "route_provider": "progorod", "measurement_system": "metric", "translit": false}, "display_model_features_link": false, "limited_domain": false, "allowed_maps": ["osm", "wikimapia", "yandexpublic", "osmmapnik"], "color_theme": "aqua", "app_color_theme": "blue_1", "privacy_policy_link": "http://privacy-policy-url", "tos": "Terms Of Service text", "no_register_commands": false, "default_user_time_zone": "Europe/London"}'

Response¶

{
    "success": true
}

Errors¶

• 247 - Entity already exists(409) - when domain already used by other dealer.