Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
minLevel1
maxLevel2
outlinefalse
typelist
separatorbrackets
printablefalse

Overview

TODO

Excerpt
nameSummaryForParentPage

APIs for the “Event Store” feature, in which the registry acts as a centralized “clearinghouse” of accomplishments and activities to support system integrations.

API Keys

API Keys are configured at the Lambda level and consist of three pieces of information:

  • user - unique user identifier

  • api_key - password or key for the user

  • scope - either “SYSTEM” (for Heuristics access) or “CLIENT” (for client access)

Configuration and diagnostics

/health
Handy status macro
set23656
isLabeledfalse
historySnapshotId3eeaa818-a8b9-49ff-8748-fd37cfbf57e6
status119749
historyChainId5fbfd900-fca2-48a5-a09a-dab56637a26b
Handy status macro
set36399
isLabeledfalse
historySnapshotId860db0d2-f319-4021-ba76-e65103a95b8f
status185954
historyChainId06a50fca-cffb-4e87-a2d5-1da3fcb525a0

Info

Returns a summary of the configuration’s health. Indicates if it is properly configured for the specified client and the results of any diagnostics that are run.

...

/configure
Handy status macro
set23656
isLabeledfalse
labelPrefix
historySnapshotId7cf4b5c1-b4fa-47de-9457-ce3d038a18ab
status119751
historyChainId97ac742e-abd6-48de-bdb9-389b2e28a0ee
Handy status macro
set36399
isLabeledfalse
historySnapshotId9306c6de-e1ae-44e6-9505-1a389454e71b
status185952
historyChainId06a50fca-cffb-4e87-a2d5-1da3fcb525a0

Info

The /configure endpoint is used to set up a client’s initial configuration scheme.

To modify specific settings after initialization use /configureSettings

JSON Payload

Code Block
{
    "ClientId": "{{lb_client_id}}",
    "ClientCredentials": {
        "UserApiKeys": [
            { "user": "LearningBuilder", "api_key": "abcdef123", "scope": "SYSTEM" },
            { "user": "joe_schmoe", "api_key": "abcdef123", "scope": "SYSTEM" },
            { "user": "bob_dylan", "api_key": "defabc654", "scope": "CLIENT" }
        ],
        "LbApiKeyOwner": "{{lb_api_key_username}}",
        "LbApiKey": "{{lb_api_key_password}}"
    },
    "ClientSettings": {
    }
}

Parameter

Description

ClientId

Client Id that is used in learning builder

ClientCredentials

UserApiKeys

An array of API Keys for individual users. These are used to make API calls against the Lambda endpoints.

The scope is either “SYSTEM” or “CLIENT”.

LbApiKeyOwner

LearningBuilder API key. Used when the Lambda makes API calls to LearningBuilder.

LbApiKey

ClientSettings

LbHostOverride

The hostname to use when making API calls back to LearningBuilder.

When empty, the Lambda uses the LbConfiguration.ClientLbDomain value for {CLIENT_ID}

If you need to override that value during testing or troubleshooting, enter the fully qualified hostname here.

...

/configureSettings/{PROGRAM_ID}
Handy status macro
set23656
isLabeledfalse
labelPrefix
historySnapshotId7cf4b5c1-b4fa-47de-9457-ce3d038a18ab
status119751
historyChainId97ac742e-abd6-48de-bdb9-389b2e28a0ee
Handy status macro
set36399
isLabeledfalse
historySnapshotId97fbd867-c034-4221-9016-c49cd2fcd0ff
status185953
historyChainId06a50fca-cffb-4e87-a2d5-1da3fcb525a0

Info

Updates one or more of the configuration settings at a time, without sending the entire configuration document.

NOTE: This can not be used to change API Key credentials. Use /setUserCredentials for that.

JSON Payload

Code Block
{
    "settings": [
      { "name": "xxx", "value": "some new value"}
    ]
}

Parameter

Description

settings

Array of settings to set

name

Name of the setting to update.

This must be “scope-prefixed” with the name of the relevant settings bucket, e.g.:

  • “ClientCredentials.NursysUsername”

  • “ClientSettings.SomeValue”

value

Value to set

...

/setUserCredentials/{CLIENT_ID}
Handy status macro
set23656
isLabeledfalse
labelPrefix
historySnapshotId7cf4b5c1-b4fa-47de-9457-ce3d038a18ab
status119751
historyChainId97ac742e-abd6-48de-bdb9-389b2e28a0ee
Handy status macro
set36399
isLabeledfalse
historySnapshotId9306c6de-e1ae-44e6-9505-1a389454e71b
status185952
historyChainId06a50fca-cffb-4e87-a2d5-1da3fcb525a0

Info

Adds or updates API Keys for individual users.

JSON Payload

Code Block
{
    "user": "some_user_identifier",
    "api_key": "abcdef12345",
    "scope": "SYSTEM|CLIENT"
}