Marketplace connection activity added to the Streaming API

The Inform Streaming API can now be used to receive events when a user connects to or disconnects from an API/cloud-based source via the Validic Marketplace. With this change, you can be notified when the connection status of API-based sources changes.

This gives you a more proactive indication of connection change compared to checking the user's marketplace or the user's profile. Those methods are still available, and useful when you need to determine the current connection status of the user's API-based sources.

🚧

Connection events must be configured when creating the stream

The data format for connection events differs from data events. Therefore, existing streams will not automatically start reporting connection events.

To start receiving connection events via the Streaming API, you will need to create a new stream that explicitly includes the connection event type filter (event_type_filter) as shown in the following code samples.

Creating a stream that includes Connection events

The following code sample demonstrates a create stream API request to create a stream that only includes connection events.

curl --location --request POST 'https://streams.v2.validic.com/streams?token=21c75c.....33e083' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "ConnectionStream",
  "event_type_filter": ["connection"]
}'

The following code sample demonstrates a create stream API request to create a stream that includes both data and connection events.

curl --location --request POST 'https://streams.v2.validic.com/streams?token=21c75c59cfd4234eaf0267df2333e083' \
--header 'Content-Type: application/json' \
--header 'Cache-Control: no-cache' \
--data-raw '{
  "name": "ConnectionandDataStream",
  "event_type_filter": ["data", "connection"]
}'

You can learn more about the new connection event types in our help documentation.