Create API Configuration in Platform

Before you begin

  • You have administrator access to Unica Platform configuration.
  • You have the target endpoint URL, the authorization type, and any credentials the endpoint requires.

About this task

Define the connection details for an external REST endpoint once, as an API configuration in Unica Platform. Destinations refer to this configuration by name, instead of embedding connection details and credentials directly in the destination.

Procedure

  1. Log in to Unica Platform as an administrator and navigate to Settings > Configuration.
  2. Expand UnicaDetect > API Connectors.
  3. Select New API Connector to create a configuration from the template.
  4. Enter a name, and in Target Endpoint, enter the URL that receives events by HTTP POST, for example http://api.example.com/events.
  5. From the Authorization Type drop-down menu, select the authorization scheme the endpoint requires.
    1. Select NoAuth if the endpoint does not require an Authorization header. This is the default.
    2. Select Basic Auth to send credentials as HTTP basic authentication.
    3. Select Bearer Token to have Detect fetch and cache an access token.
    Important:
    When basic authentication or bearer token is selected, the corresponding user id and password has to be maintained in user's data source.
  6. Set Connection Timeout in Millis and Read Timeout in Millis.

    These control how long Detect waits to open a connection and to receive a response before treating the attempt as failed and eligible for retry. If you leave these blank, Detect uses default values; see API Connector Configuration Properties.

  7. Save the configuration.

Results

The API configuration is available in Platform. You can now reference it by name from one or more destinations; see Configure Destination with API Connector.