API Keys and Authentication
API keys are generated via the instructor dashboard. If you are an admin on your account, you can generate one under the gear icon in the header --> "API Credentials" --> "Create an API Key". You can use this API key to begin making a few basic API calls.
Skilljar's API endpoint is https://api.skilljar.com/v1
API calls are authenticated via HTTP Basic Authentication. The API Key is the User, and the password is blank. For example, if your key is "sk-live-abcdeg", then all requests to our API endpoint should contain the HTTP Header:
Authorization: Basic c2stbGl2ZS1hYmNkZWc6
That is, where
c2stbGl2ZS1hYmNkZWc6 is the base-64 encoded string sk-live-abcdeg: as per the HTTP Basic Auth spec. Most HTTP libraries will do this for you, so you don't have to worry about constructing and adding the header explicitly.
First API call - Ping the API endpoint
You can test a basic call & response via making an HTTP GET request to our "ping" endpoint:
A successfully authenticated request should return an empty 200 response.
You'll notice if you access the
/ping endpoint in your browser (and paste in your API key in the username prompt), you'll see a full HTML page with the API response. All of our APIs are accessable in this way to facilitate debugging.
To communicate with our endpoint using JSON encoding, you will want to specify it the
Accept: header in your HTTP request. This doesn't apply much to the
/ping endpoint since there is an empty response, but will apply once you start making legitimate API calls:
API Resource Reference
There are a few main resources within the Skilljar API. REST-like manipulation of these resources allow you to manage users within the course platform, enroll users in courses, and receive event notifications from the platform.
This is the domain your courses are hosted on, e.g. courses.yoursite.com
user is a student within the system.
This is a course.
A course is published to a domain via a
A user has access to a domain via a
A user is enrolled in a
PublishedCourse via an
You can be notified of events within the course platform via
The Details - API Endpoint Reference
Now that you understand how to make an API call, and what the primary resources are within the system, it's time to browse the API Endpoint Reference. The reference lives on your API endpoint and is generated dynamically from the source code itself. It's always up-to-date with the latest details about the platform.
The article Common API Tasks outlines some common uses of the Skilljar API and gives examples of using the API to create users, enroll them in courses, add them to domains, etc..