Skip to content

API Configuration

  • The API Configuration tab allows users to enable the SmartSub API and have access to the keys, secrets, endpoint, and unit identifiers.

ManageClientAPIConfig

Configuration Fields

  • API Access Enabled: Toggle to enable or disable API access for your organization
  • API Key: Unique key used for API authentication
  • Shared Secret: Secret value used for HMAC signature generation
  • Endpoint: Base API URL (scheme and hostname only, e.g., https://qa-api.smartsub.com)
  • RMU: Registration and Staff Management Unit identifier (GUID)
  • SMU: Substitute Management Unit identifier (GUID) - if applicable

Actions

  • Clicking the ClipboardIcon will copy that field to the clipboard

  • Clicking the GenerateAPIButton will generate a new API key or Shared secret

  • Click the SaveAPIButton to save the current API configuration

  • Click the APISampleHeadersButton to display sample headers

APISampleHeaders

  • Click the APITestAuthenticationButton to test the API connection authentications

External Application Configuration

When configuring external applications (SCView, CSIU, etc.) to connect to the SmartSub API, you will need:

  1. Endpoint: The base URL (e.g., https://qa-api.smartsub.com)
  2. API Key: For authentication
  3. Shared Secret: For HMAC signature generation
  4. RMU/SMU Identifiers: To construct the appropriate API paths (e.g., /v1/rmu/{guid}/...)

All fields can be copied to the clipboard using the clipboard icon next to each field.