Service API Configuration

This module is currently unavailable and will be available in future versions. The documentation below is provided for reference only.

Service API Configuration manages the configuration for the Service API module, including API settings, mail, speed test, subscription, service groups, and wireless parameters.

When to use it

Use Service API Configuration when you need to:

  • configure API connection settings and parameters,

  • manage mail service configuration,

  • set up speed test parameters,

  • define subscription service settings,

  • configure service groups,

  • manage wireless network parameters,

  • export configuration before making changes,

  • import updated configuration with a dry-run preview.

Prerequisites

Before working with Service API Configuration:

  • Confirm you are logged into the correct environment.

  • Confirm your permissions:

    • VIEWER — browse configuration and Export.

    • EDITOR / ADMIN — edit settings and Import.

VIEWER accounts run in read-only mode. Write actions (Edit/Save) are blocked.

Configuration sections

Service API Configuration is organized into tabs:

API

Core API connection settings, endpoints, and authentication parameters.

Mail

Mail service configuration including SMTP settings, templates, and delivery options.

Speed Test

Parameters for network speed testing functionality.

Subscription

Subscription service settings and configurations.

Service Group

Service group definitions and mappings.

Wireless

Wireless network configuration parameters.

Browse and edit

  1. Use the tab navigation to switch between configuration sections.

  2. Review current settings in each section.

  3. Edit inline fields to modify values.

  4. Changes are tracked automatically.

  5. The Unsaved Changes badge appears when modifications are pending.

Autosave

  • Draft changes are automatically saved to local storage as you edit.

  • If you navigate away or close the browser, your draft is preserved.

  • When you return, you’ll see a notification that your draft was restored.

Autosave uses browser local storage and is specific to your device.

Save changes

  1. Make edits in one or more sections.

  2. Click Save in the toolbar.

  3. Changes are persisted to the server.

  4. The autosaved draft is cleared.

Expected outcomes:

  • On success, the configuration updates and the Unsaved Changes badge disappears.

  • If validation fails, errors are shown and save is blocked.

Discard changes

  1. Click Refresh in the toolbar.

  2. If you have unsaved changes, a confirmation dialog appears.

  3. Confirm to discard changes and reload the configuration from the server.

This action clears the autosaved draft.

Export configuration

  • Click Export to download a YAML file with the current configuration.

What is exported:

  • All configuration sections (API, Mail, Speed Test, Subscription, Service Group, Wireless).

  • Current values from the server (not draft changes).

  • Format: YAML.

Import with dry-run

  1. Click Import and upload a YAML file.

  2. Review the dry-run preview showing proposed changes.

  3. If warnings exist, enable Allow warnings before applying.

  4. Apply the import and the configuration refreshes.

Expected outcomes:

  • Dry-run runs automatically after file selection.

  • Warnings require explicit confirmation before apply.

  • Errors block apply until resolved.

  • Import replaces the entire configuration.

  • Autosaved draft is cleared after successful import.

Refresh configuration

  1. Click Refresh to reload the current configuration from the server.

  2. If unsaved changes exist, a confirmation dialog appears first.

  3. Use after imports or changes by other operators.

Troubleshooting

Edit actions are disabled

Confirm your role is EDITOR or ADMIN.

Save is disabled

Ensure you have made changes to the configuration. Fix any validation errors in the form fields.

Cannot see my changes after save

Click Refresh to reload the configuration and verify changes persisted.

Import blocked by errors

Fix the reported issues in the YAML file and re-import.

Draft not restoring

Check that browser local storage is enabled and not blocked.

Autosave not working

Ensure local storage quota is not exceeded. Try clearing old autosaved drafts.