Read community data

You can use APIs to read community data shared with your tenant. The steps are:

1. Connect to CONNECT data services with a role that has access to communities.

2. From the navigation menu, select Developer Tools > API Console. Verify that:

   • The Change the targeted API version dropdown is set to v1-preview or later.
   • Root path is enabled (disable the Home icon).

3. Copy the ID for the community containing streams you want to access.

   From the URI field, set the URI to the List Communities a Tenant is Joined to endpoint, and then query for the list of communities that your tenant is connected to. Copy the Id of a community that you want to access data from.

   Tenant community memberships

   Tip: Alternatively, you can obtain the ID for the relevant community by browsing to Data Management > Communities in the portal, selecting the relevant community, and copying its ID.

4. Using the List Streams By Community endpoint, query for streams using a community Id (like one obtained in the previous two steps).

   Community streams

5. From the Body tab, copy the relevant stream's Self link and paste it into the URI field.

   Copy self link

   Note: This method is the easiest because it includes region information, tenant information, and namespace information needed for the stream URL.

   See Definitions and Get Stream.

6. Enter the community Id in the Community-Id header parameter.

   Enter Community ID in header

7. Use the resolved route with the Community-Id in the header to get type information; types can not be accessed directly. See Get Resolved Stream.

   Resolved community stream with type information

8. Use data calls as normal, including the header Community-Id parameter. See Stream Data.

   Community ID included in normal data calls