Skip to content
English
  • There are no suggestions because the search field is empty.

Completions Export Integration

16549029293715 2023-05-11 09-57-46

Completion Event

A completion event in the scope of the Cybrary is when a user completes an activity that is within the view of the organization. The following types of content will generate completion events tracked in this integration: 

  • Course

  • Lab

  • Assessment

  • Career Path

Credentials and Access

Completion exports can be accessed via API

 

API Access

OAuth Credentials will be provided by Cybrary

Access Token URL: https://app.cybrary.it/auth/oauth/token

Scope: "use-integrations"

Client Authentication should be Basic Auth Header

 

Available Methods

URL

Sample Response

Description

GET https://app.cybrary.it/courses/api/integrations/completions See Export List Format Returns a list of exports by date that can be retrieved
GET https://app.cybrary.it/courses/api/integrations/completions/{date} See Export Format Section JSON response with the given response
GET https://app.cybrary.it/courses/api/integrations/completions/latest See Export Format Format JSON response with the given response

 

Export List Format

[
{
"date":"01_25_2020",
"url":"https://app.cybrary.it/courses/api/integrations/completions/01_25_2020"
},
{// ... //}
]

Export Format

Data will be delivered in JSON format as an array of objects in which each object will contain a set of XAPI statements that are relevant for each instance of a completion event.

Files will be named as follows: xapi_completion_export_DD_MM_YYYY.json

DD_MM_YYYY would represent the date that the file covers the export for, e.g. xapi_completion_export_22_01_2020.json

A single file will be generated for each day. The file will contain data for events that have happened on that date in UTC time zone. This may include completions for past dates.

[{
"timestamp": "2019-11-13T16:07:23.726Z",
"actor": {
"name": "John Doe",
"mbox": "mailto:user@example.com"
"account": {
"homePage": "https://www.cybrary.it/",
"name": "1985071"
}
},
"verb": {
"id": "http://adlnet.gov/expapi/verbs/completed",
"display": {
"en-US": "completed"
}
},
"result": {
"completion": true,
"success": true
},
"object": {
"id": "https://www.cybrary.it/course/intro-to-data-science/",
"definition": {
"type": "http://adlnet.gov/expapi/activities/course",
"name": {
"en-US": "Intro to Data Science"
},
"extensions": {
"https://www.cybrary.it/contentDescriptionId": "8793",
"https://www.cybrary.it/continuingEducationUnits": 4,
"https://www.cybrary.it/learningHours": 3.449
}
}
}
},
{
//// Next Statement ///

}]

 

Field Descriptions

Field Group Field Description
actor name User-Provided Name in Cybrary system
actor.account homePage https://www.cybrary.it (future Use)
actor.account name The id of the user in our system
verb id This will currently always state completed in the current implementation
verb display.en-US This will currently always state completed in the current implementation
object id URL to the page describing the activity
object.definition type Type of activity assigned to the activity object (e.g. course, lab, assessment)
object.definition name.en-US Title of the activity object in the given locale
object.extensions https://www.cybrary.it/contentDescriptionId Cybrary ID for the activity
object.extensions https://www.cybrary.it/continuingEducationUnits The number of Continuing Education Credits given for the activity
object.extensions https://www.cybrary.it/learningHours Number of Learning Hours given for the activity object by Cybrary

 

If you have any questions, please contact your dedicated Customer Success Manager for assistance.