Learning Hub

Owned by Seth Petry-Johnson
Last updated: Sept 26, 2024
2 min read

The Learning Hub is a data sharing platform that is independent from LearningBuilder. It connects organizations that publish event data (such as a Practitioner completing a course) to the organizations that want to consume that data (e.g. to satisfy application requirements).

Overview

The organizations that participate in the Learning Hub are identified as Publishers or Subscribers.

  • Publishers put data into the hub.

  • Subscribers pull data out of the hub and do something with it.

image-20240926-165932.png

The primary benefits of the Learning Hub are:

  • Publishers and Subscribers do not call each other’s APIs directly, ensuring that they cannot adversely impact the performance of the other party’s systems;

  • Standard APIs make it easier to integrate with LearningBuilder by reducing or eliminating custom code.

The Learning Hub is NOT specific to LearningBuilder! It can also be used to import data from a 3rd party system into LearningBuilder, or to export data from LearningBuilder out to a 3rd party system.

Development guides

For instructions on how to get started with an integration, see these links:

Calling the APIs

The Learning Hub exposes multiple APIs for different tasks. Those are listed in the following section.

All of the APIs share a common hostname and authentication system.

API Hostnames

Authentication

System administrators: see https://heuristicsolutions.atlassian.net/wiki/spaces/~499343847/pages/3715269677

Endpoints in this API use one of two different authentication methods, which are documented in the individual API pages.

Method

Explanation

Method

Explanation

An AWS access/secret key used by system administrators for system configuration and provisioning when API Keys may not be configured yet.

When using Postman, pass these as an AWS Signature

Credentials assigned to a specific user or client, consisting of a userId and an apiKey. These are assigned during client onboarding.

{Base64EncodedCredentials} = BASE64(userId + ":" + apiKey) Authorization: Basic {Base64EncodedCredentials}

API Documentation

API

Purpose

API

Purpose

Event Store API

Allows Publishers to put data into the Hub, and to view their data already in the Hub.

Event Subscription API

Allows Subscribers to get data out of the Hub.