Versions Compared

Key

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

...

Calling the API

Insert excerpt
Certification RegistryCertification RegistryLearning Hub
Learning Hub
nameCertRegistryApiHostnames
nopaneltrue

...

Method

Explanation

Handy status macro
set36399
isLabeledfalse
historySnapshotIdac74f399-bd5a-4c94-85f2-fa2f46fde05c
status185953
historyChainId06a50fca-cffb-4e87-a2d5-1da3fcb525a0

These endpoints require an API Key, assigned by the system administrators.

These should be passed using Basic Authentication

If the endpoint requires a {PROGRAM_ID}, then this key must either be a SYSTEM key or have access to the specified Program.

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.

...

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.

...

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

...

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

...

Publishing events into the Registry

TODO

Pulling events from the Registry

TODO