Settings | Event Subscriptions

Returns a single event subscription.

Same credential rule as the list endpoint: clientSecret and credential header values are null. This is the call to make before a PUT, since the object you get back is the correct starting point for a replacement.

get/api/EventSubscriptions/{id}

Request

  • Base URL: https://api.omnium.no (the document declares no server; this is the origin it was published from)
  • URL: https://api.omnium.no/api/EventSubscriptions/{id}
  • Auth: API key in header Authorization

Path parameters

idstring nullable required

Id of the subscription.

Response

Subscription returned. Credentials are omitted.

idstring nullable

Unique identifier. Assigned by Omnium when omitted on create; supply your own to keep ids stable across environments.

namestring required

Name shown in the UI and included in delivery log entries.

isActiveboolean

When false the subscription is kept but no events are delivered.

connectorstring required

Delivery mechanism. Built-in values are Webhook, AzureServiceBus, AzureStorageQueue, Kafka and RabbitMQ; installed integration modules may add more.

baseUrlstring nullable

Target host for HTTP delivery, for example https://example.com. Required by the Webhook connector.

requestUristring nullable

Path appended to Omnium.Public.Events.Models.OmniumEventSubscription.BaseUrl, for example /hooks/orders.

httpVerbstring nullable

HTTP method used for delivery, for example POST.

topicstring nullable

Queue, topic or stream name. Used by the queue and bus connectors instead of a URL.

clientIdstring nullable

Client id used to authenticate against the destination.

clientSecretstring nullable

Client secret or connection string used to authenticate against the destination. Write-only: always returned as null. Omit it on update to keep the stored value, or send an empty string to clear it.

messageEncodingstring nullable

Character encoding of the delivered message body, for example UTF-8.

useQueueDeliveryboolean

When true, events are put on an internal queue and delivered asynchronously with retries instead of being sent inline.

Changes

No recorded changes to this operation across all 1 revision of this API.