Concepts

Academic Benchmarks includes a controlled vocabulary of Concepts that has been used for over 15 years to aid in building relationships between content or assessment items (together referred to as Assets) and Standards. AB Connect Content Enrichment tools (Clarifier and prediction engine) are built on top of the Concepts. Each Concept represents a unique notion that a Standard or Asset covers. Academic Benchmarks unpacks Standards into groups of Concepts called key_ideas which can be retrieved via the Standards endpoint. Similarly, Assets can be related to Concepts which can act as an intermediary between Assets and Standards.

Topics are a similar intermediary controlled vocabulary but while Topics are comparatively broad or higher level than Standards, Concepts are very granular and operate at the unpacked Standard level.

The Concepts resource can be used to access the Academic Benchmarks Concepts and related metadata. Use of the API ensures the most current Concepts data is available to your application. At this point in time, the Concepts endpoint is relatively simple as the expectation is that partners will use Standards or Topics as a starting point for building an Asset's metadata profile and then refine it using the Clarifier. However, this endpoint does allow the caller to retrieve context of the Concept which can clarify ambiguous terms.

The relationship between Concepts and other objects are tracked and reported via the other objects. For example, to understand what Concepts a Standard encompasses, retrieve the concepts list via the Standard endpoint (or see the key_ideas field). Similarly, the Asset endpoint can be used to associate Assets with Concepts and retrieve the current relationship. See also the Clarifier endpoint to further explore potential relationships between Concepts, Standards and Assets.

All calls against the Concepts resource must be implemented as HTTP GET requests, and must include proper Partner Authentication Credentials.

Note that access to AB Concepts is licensed separately. If your credentials are correct and you are still receiving a 401 error (or no results), check with AB Support to ensure you are licensed for Concepts. See the section on Licensing Considerations for a discussion on the licensing required for access to Key Ideas and Concepts.

Single Concept

In its simplest form, you are able to retrieve the details of a specific Concept by appending the AB GUID to the path portion of the URL.

Fetching a Concept

GEThttps://api.abconnect.instructure.com/concepts/{guid}

Path parameters

guid*string

guid of specified concept

Query parameters

Response

200400401404

Successful operation

Body

application/json

linksSelfLink (object)

metaSimpleMetadata (object)

dataConcept (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.abconnect.instructure.com/concepts/{guid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401404

{
  "links": {
    "self": "text"
  },
  "meta": {
    "took": 0
  },
  "data": {
    "attributes": {
      "descr": "text",
      "disciplines": {
        "subjects": [
          {
            "code": "text",
            "descr": "text",
            "guid": "text"
          }
        ]
      },
      "guid": "text",
      "context": "text"
    },
    "id": "text",
    "type": "text"
  }
}

Searching for Concepts

Using filtering and facets, it is possible to retrieve sets of Concepts that match specific criteria. These Concepts are returned in an array of Concept objects. See the Introduction for an explanation on filtering and the use of facets. This section covers the specifics of using these parameters with the Concepts resource.

Finding Sets of Concepts

GEThttps://api.abconnect.instructure.com/concepts

Query parameters

Response

200400401

OK

Body

application/json

linksLinks (all of)

metaMetadata (all of)

dataarray of Concept (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.abconnect.instructure.com/concepts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401

{
  "links": {
    "self": "text",
    "first": "text",
    "last": "text",
    "next": "text",
    "prev": "text"
  },
  "meta": {
    "took": 0,
    "limit": 0,
    "count": 0,
    "offset": 0,
    "facets": [
      {
        "count": 0,
        "facet": "text",
        "details": [
          {
            "data": {
              "descr": "text",
              "code": "text",
              "guid": "text"
            },
            "count": 0
          }
        ]
      }
    ]
  },
  "data": [
    {
      "attributes": {
        "descr": "text",
        "disciplines": {
          "subjects": [
            {
              "code": "text",
              "descr": "text",
              "guid": "text"
            }
          ]
        },
        "guid": "text",
        "context": "text"
      },
      "id": "text",
      "type": "text"
    }
  ]
}