Introduction
This page describes sample structures for the top-level objects in CTDL, as you would find them in the Registry. Contact Us if you have any questions.
Data in the Registry
In the Registry, there are several classes that can be accessed directly via their URIs. These classes are commonly referred to as "top level classes":
- ceterms:CredentialOrganization and ceterms:QACredentialOrganization
- ceterms:Credential (including all its subclasses)
- ceterms:AssessmentProfile
- ceterms:LearningOpportunityProfile
- ceterms:ConditionManifest
- ceterms:CostManifest
- ceasn:CompetencyFramework
- ceasn:Competency
There are two ways to retrieve such objects: via the object's graph URI and via the object's resources URI. Depending on which option you choose, the data you receive will have different wrapping structures (the core data will be identical). Compare:
Record retrieved via graph URI ( e.g., https://credentialengineregistry.org/graph/ce-01496a63-5c64-4ec3-aa2a-07a8fb184bef ):
The same record retrieved via resources URI ( e.g., https://credentialengineregistry.org/resources/ce-01496a63-5c64-4ec3-aa2a-07a8fb184bef ):
Key things to note:
- The presence of a blank node in the graph data.
- The lack of that same blank node in the resources data, even though the field in the resources record that references the blank node ( ceterms:accreditedBy )is still present in the data.
- The graph data contains everything available in the resources data.
- The @context is injected into the resources data when the resource is retrieved instead of the graph.
- It's easy to determine a graph URI from a resources URI (or vice versa): Just swap "/graph/" and "/resources/" in the URI itself.
Additionally, the Credential Registry Search API returns search results that are constructed from resources data (in order to avoid the complexity of graphs and avoid blank nodes showing as false-positive search results). If your system intends to consume search results for further processing beyond simply displaying them, it is recommended to retrieve the graph data for each result in order to ensure your system has any potentially-relevant blank nodes.
Record Examples
Organization
Credential
Assessment
Learning Opportunity
Competency Framework
Competency
For an explanation of CTDL, review the CTDL Handbook. All data in the Registry will conform to the Minimum Data Policy.