mkauffman

It's Only A Model

Blog Post created by mkauffman on Oct 12, 2018

Camelot (it's only a model) - YouTube

Ok, this is not a blog post about silly movies. I'm writing because of a recent occurrence of difficulty noticing/finding a very important piece of our REST API documentation, the .... wait for it.... Model. As described below reading through the API Models can help reduce the number of REST API calls you make and improve your experience with Blackboard Learn REST endpoints in general.

 

Here we go. When you visit a REST API, you'll see the following Response Example Value.

RESTAPI.ExampleValue.jpeg

All well and good. But! There is a lot of important information hiding under the greyed out Model link. See it? When you click on it, you see the following Model!

RESTAPI.Model.jpeg

 

You really want to read all of that because... way down in the text you'll read:

Since: 3300.9.0

user (

User):

The user associated with the membership.

Shown when adding the query parameter: "expand=user". And can be filtered with the "fields" query parameter, for example "filter=user.uuid,user.externalId".

Which means that you CAN get all of the information you'd like about users in a course when pulling course memberships, without making additional REST calls to the /users endpoint.

 

Be certain to check out the Models!

Outcomes