The “Event Store” feature of the Learning Hub is designed to capture learning “events”, such as when someone completes a course or earns a credential.

These APIs will be called by individual “Programs” to put data into, or get data out of, the Event Store.

1 Overview
- 1.1 Data model
- 1.2 EventType vs PublisherEventCategory
2 Calling the API
- 2.1 API Hostnames
- 2.2 Authentication
3 Publishing Events into the Registry
- 3.1 POST /api/events
- 3.2 DELETE /api/events/{eventId}
4 Pulling events from the Registry
- 4.1 GET /api/events/{programId}

Overview

RESTful APIs for the “Event Store” functionality of the Learning Hub, where the hub acts as a centralized “clearinghouse” of accomplishments and activities.

These APIs are called by Publishers to put data into the Learning Hub.

Data model

EVENT

EVENT
An Event is the thing being recorded in the hub: user completed a course, earned a credential, etc. This design is influenced by the idea of a Learning Record Store in xAPI, but with less complexity.
Field	Type	Notes
`EventId`	UUID (26+128 chars) (universally unique Identifier)	`E:{ProgramId}-{UUID}` The `{ProgramId}` helps guarantee uniqueness but also to make the IDs more human readable. Event Ids are assigned by the Learning Hub.
`PublisherProgramId`	string (25 char)	Descriptive name for the Program that published this event.
`PublisherSystemId`	string (25 char)	Identifier for the type of system that published this data. Currently, only the value “LB” is supported, for LearningBuilder.
`EventType`	string (50 char)	The type of event as reported by the Publisher.
`PublisherEventId`	string (200 char)	The Program’s unique identifier for the source event. For LearningBuilder this will be something like “AI:1234”, which would be the Activity Instance WFI #1234
`PublisherParticipantId`	string (200 char)	The Program’s unique identifier for the person, organization, or entity that the event relates to.
`PublisherEventCategory`	JSON object optional	High level classification of this event, within the Publisher’s system. `{ "value": "some constant value", "label": "some human readable value" }` The `value` property should be an ID or code that represents the event type to the Publisher. The `label` property is a human readable explanation of that value, at the time of publishing. The `label` can change over time, but the `value` should stay constant.
`PublisherEventData`	JSON blob	The Publisher’s representation of the event data.
`EventStartUtc`	UTC date/time	Non-null date/time the event started. (If only a single date/time is associated with the event, it is stored here).
`EventEndUtc`	UTC date/time	Nullable date/time that the event ended.
`CreatedUtc`	UTC date/time	UTC timestamp when this record was created.
`EventDateBucket`	string	`{ProgramId}-LB-YYYYMMDD` Gathers the year, month, and date from the `CreatedUtc` field. Identifier used by the LearningHub query that gathers events to process.

`EventType` vs `PublisherEventCategory`

EventType is a system concept that indicates if data is being reported, updated, deleted, etc. These are fixed values that have specific meaning to the Hub.

PublisherEventCategory is a Publisher concept that differentiates different types of events in their system, such as “Course” or “Exam Result”. These are NOT fixed values and will vary by Publisher. (For LearningBuilder Publishers, this will usually be the Activity Type)

Subscribers can subscribe to specific event categories for specific Publishers, with separate mapping templates for each category.

Calling the API

API Hostnames

See Learning Hub | API Hostnames

Authentication

See Learning Hub | Authentication

Publishing Events into the Registry

`POST /api/events`

JSON Payload

{
    "PublisherProgramId": "YourProgramId",
    "PublisherSystemId": "YourSystemName",
    "PublisherEventId": "some_key_from_your_system",
    "EventType": "AI_COMP_SUCCESS",
    "PublisherParticipantId": "joebob@example.com",
    "PublisherEventCategory": { "value": "some_key", "label": "friendly description" },
    "PublisherEventData": { JSON },
    "EventStartUtc": "UTC date/time",
    "EventEndUtc": "UTC date/time"
}

Parameter	Description

Parameter	Description
`PublisherProgramId`	The Program that owns the Event. The API Key must have access to this Program.
`PublisherSystemId`	The type of system that published the event. This is an arbitrary string provided by the Publisher. Can be used when a Publisher has multiple systems pushing data into the Hub.
`EventType`	The type of Learning Hub Event this record represents. For now, the only supported value is “AI_COMP_SUCCESS”
`PublisherEventId`	A value that uniquely identifies this event in the Publisher’s system. For LearningBuilder Publishers, this will be an “entity-scoped identifier” such as `AI:1234`, representing Activity Instance 1234.
`PublisherParticipantId`	Email address or some other piece of information that uniquely identifiers the primary participant within the Publisher's system. Ideally, this is an email address or some other identifier that is shared with the Subscribers.
`PublisherEventCategory`	JSON object containing information about the type of Event, according to the source Program’s system. The `value` should be some sort of stable identifier with meaning to the Publisher. This value will determine the Template that will be used in the `/processEvent` endpoint. The `label` should be a human readable value that helps explain the event category to Subscribers. `{ value: "ABC123", label: "Online Course" }`
`PublisherEventData`	JSON object representing the Event in the source Program’s system. When calling `/processEvents` endpoint, this data will be put thru a template and sent to learningBuilder.
`EventStartUtc`	The UTC date/time when this Event occurred, or the time that the Event started.
`EventEndUtc`	The UTC date/time when this Event ended. For Events with only a single timestamp, rather than a range, set this equal to `EventStartUTC`.

PublisherEventData Node Example

The exact fields and field names in the PublisherEventData node will be determined as part of the implementation process, as these are determined by the LearningBuilder instance configuration and that data the Publisher is providing to the LearningHub.

Responses

Response Code	Headers and Body

Response Code

Headers and Body

201 (Created)

A new Event was created. No body is returned.

HTTP headers:

Location: /events/{eventId}

`DELETE /api/events/{eventId}`

Responses

Response Code	Headers and Body

Response Code	Headers and Body
204 (No Content)	Delete was performed successfully. No body is returned.

Pulling events from the Registry

`GET /api/events/{programId}`

Querystring parameters

Parameter	Description

Parameter	Description
`createdOnUtc`	(required) The created-on date to match. Date format `"YYYYMMDD"`

Responses

Response Code	Headers and Body

Response Code	Headers and Body
200 (Ok)

LearningBuilder Documentation

Learning Hub: Event Store APIs

Overview

Data model

EVENT

EVENT

`EventType` vs `PublisherEventCategory`

Calling the API

API Hostnames

Authentication

Publishing Events into the Registry

`POST /api/events`

JSON Payload

PublisherEventData Node Example

Responses

`DELETE /api/events/{eventId}`

Responses

Pulling events from the Registry

`GET /api/events/{programId}`

Querystring parameters

Responses

Learning Hub: Event Store APIs

Overview

Data model

EVENT

EVENT

EventType vs PublisherEventCategory

Calling the API

API Hostnames

Authentication

Publishing Events into the Registry

POST /api/events

JSON Payload

PublisherEventData Node Example

Responses

DELETE /api/events/{eventId}

Responses

Pulling events from the Registry

GET /api/events/{programId}

Querystring parameters

Responses

`EventType` vs `PublisherEventCategory`

`POST /api/events`

`DELETE /api/events/{eventId}`

`GET /api/events/{programId}`