Satori Docs

Your definitive guide to subscribing and publishing live data

Register Live Channel Direct link

This article describes how to add and test a live channel, get it verified and made public.

Add Live Channel in Dev Portal Direct link

To add a live channel:

  1. In the Dev Portal, navigate to Live Data > Create a live channel.dp-och-adding.png#asset:3033:url
  2. Specify the following information:

    • Channel title: The channel title identifies the channel in the Live Data Channel.

    • Channel name: The name of the channel must be unique within Satori live channels and, once assigned, it should not be changed.

    • Description: Include a description so that other Satori users have more details about messages in your channel. For example, you can explain where the data comes from and how others can benefit from your channel.
      In case of republishing live data, channel description should contain the data source URL, polling frequency, data attribution (if needed), and any required by app developers subscribed to this channel.

    • Tags: Includes at least one tag that is relevant to the channel that your submission pertains to. The tag must not be misleading, insufficient, inaccurate, incomplete, or otherwise improper.

  3. Select to accept the terms and policy.
  4. Click Add.

Connection and Permissions

Once a new live channel is added, it is automatically assigned the publish and subscribe permissions with a fixed role and a secret key for authentication. Verified live channel permissions are set so that anyone can subscribe to the channel with or without role authentication, but only properly authenticated connection with the provided role is allowed to publish. For a general overview, see Access Control.

Click the name of the channel you just added and click the Publish / Subscribe tab.  Note the values of the Appkey, Endpoint, Role name , and Role secret key. You will need these to publish live data.

Unverified Status

The Dev Portal adds the live channel with a status of Unverified. Until your channel is verified, it will not be available to the public, but you can now privately publish live data to the channel.

Test Live Channel with Web Console Direct link

Use the Web Console in the Dev Portal to test and explore your channels: you can view and publish channel messages in it.

  1. In the Dev Portal, navigate to Live Data > My channels.
  2. Click the channel title and click the Console tab.
    The Web Console automatically connects and authenticates with RTM, subscribes to the selected live channel, and displays the messages being published to it.

See Monitor Channels in Web Console for more information about the Web Console.

Verify Live Channel and Go Public Direct link

After you create and test a live channel, review the following Satori terms of use and the privacy policy:

When you are certain that your data conforms to the guidelines, submit the channel for verification:

  1. To get a live channel verified, you must first start publishing a live data stream to it.
  2. In the Dev Portal, navigate to Live Data > My channels.
  3. Click the channel title and click Submit for verification.
    Satori will check the channel for compliance and confirms its status.

Verification certifies that your live channel meets the Satori live data guidelines for content, format, and consistency. 

If your live channel does not meet the guidelines, Satori blocks it and sends you a notification. You can make any necessary change to the channel and re-submit for verification.

Once your channel has been verified, it becomes public and can be found in Live Data Portal.