CampusAPI Assessment Services API documentation version 0.1.5
Based on OSID version 3.0.0
https://base.url/assessment
Overview
The Assessment package provides the means to create, access, and take assessments. An Assessment may represent a quiz, survey, or other evaluation that includes assessment Items. Assessment Items are extensible objects to capture various types of questions, such as a multiple choice or an asset submission.
The Assessment services define functionality to describe the flow of control and the relationships among the objects. Assessment Items are extensible objects to capture various types of questions, such as a multiple choice or an asset submission.
This package includes the following entities:
Questions
A Question represents the question portion of an assessment item.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this question, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this question, provided by system. | string(uri) |
displayName | The name of this question for display. | string |
description | The description of this question. | string |
genusTypeId (read‑only) | Id of the immutable type of this question. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this question. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
Answers
An Answer represents the answer portion of an assessment item.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this answer, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this answer, provided by system. | string(uri) |
displayName | The name of this answer for display. | string |
description | The description of this answer. | string |
genusTypeId (read‑only) | Id of the immutable type of this answer. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this answer. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
Items
An Item is an individual assessment item such as a question to be included in a test. Items always have a Question part and may also have one or more Answer parts
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this item, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this item, provided by system. | string(uri) |
displayName | The name of this item for display. | string |
description | The description of this item. | string |
genusTypeId (read‑only) | Id of the immutable type of this item. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this item. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
learningObjectiveIds | Any Objectives corresponding to this item. References an array of learning.Objective objects. | string(osid‑id)[] |
questionId | The Question. References an assessment.Question object. | string(osid‑id) |
answerIds | The Answers. Questions may have more than one acceptable answer. References an array of assessment.Answers objects. | string(osid‑id)[] |
Assessments
An Assessment represents a sequence of assessment items. Basic assessment authoring functionality for simple Assessments (those without Sections or Parts and which do not support Sequencing rules) is supported. More complete and advanced Assessment authoring is covered in the Assessment Authoring service area.
An Assessment may have an accompanying rubric used for assessing performance. The rubric assessment is established canonically in this Assessment.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this assessment, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this assessment, provided by system. | string(uri) |
displayName | The name of this assessment for display. | string |
description | The description of this assessment. | string |
genusTypeId (read‑only) | Id of the immutable type of this assessment. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this assessment. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
levelId | The Grade corresponding to the assessment difficulty. References a grading.Grade object | string(osid‑id) |
rubricId | The rubric. References an assessment.Assessment object | string(osid‑id) |
AssessmentsOffered
An AssessmentOffered is an Assessment available for taking. Additional information can be included about when the assessment can be taken, its duration, whether assessment Items can be shuffled, whether they must be taken in sequence, etc.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this assessment offered, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this assessment offered, provided by system. | string(uri) |
displayName | The name of this assessment offered for display. | string |
description | The description of this assessment offered. | string |
genusTypeId (read‑only) | Id of the immutable type of this assessment offered. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this assessment offered. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
assessmentId (read‑only) | The assessment associated with this assessment offered. References an assessment.Assessment object. | string(osid‑id) |
levelId | The Grade corresponding to the assessment difficulty. References a grading.Grade object | string(osid‑id) |
itemsSequential | Tests if the items or parts in this assessment are taken sequentially. | boolean |
itemsShuffled | Tests if the items or parts appear in a random order. | boolean |
startTime | The start time for this assessment. | string(date‑time) |
deadline | The end time for this assessment. | string(date‑time) |
duration | The duration for this assessment. | string(duration) |
scoreSystemId | The grade system for the score. References a grading.GradeSystem object | string(osid‑id) |
gradeSystemId | The grade system for the grade. References a grading.GradeSystem object | string(osid‑id) |
AssessmentsTaken
An AssessmentTaken is an AssessmentOffered that has been completed or in progress by a Taker (typically a student).
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this assessment taken, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this assessment taken, provided by system. | string(uri) |
displayName | The name of this assessment taken for display. | string |
description | The description of this assessment taken. | string |
genusTypeId (read‑only) | Id of the immutable type of this assessment taken. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this assessment taken. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
takerId (read‑only) | The taker associated with this assessment taken. References a resource.Resource object. | string(osid‑id) |
takingAgentId (read‑only) | The taking agent associated with this assessment taken. References an authentication.Agent object. | string(osid‑id) |
actualStartTimeId (read‑only) | The actual start time associated with this assessment taken. References a calendaring.DateTime object. | string(osid‑id) |
assessmentOfferedId (read‑only) | The assessment offered associated with this assessment taken. References an assessment.AssessmentOffered object. | string(osid‑id) |
takerId | The Resource taking this assessment. References a resource.Resource object | string(osid‑id) |
Banks
Items, Assessments and all other "assessment" related entities can be organized into catalogs called Banks.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this bank, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this bank, provided by system. | string(uri) |
displayName | The name of this bank for display. | string |
description | The description of this bank. | string |
genusTypeId (read‑only) | Id of the immutable type of this bank. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this bank. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
providerId | The provider of this bank. References a resource.Resource object. | string(osid‑id) |
brandingIds | The branding of this bank. References repository.Asset objects. | string(osid‑id)[] |
license | The licensing that applies to this bank. | string |
License
CampusAPI REST Documentation Copyright 2023 DXtera Institute. Based on the Open Service Interface Definitions: http://osid.org
/items
Collection of Items in a system, federation of systems, or in a default Bank.
Get all Items in the system or default Bank.
Create a new Item in the default Bank.
get /items
Get all Items in the system or default Bank.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "learningObjectives", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleItemType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleItemType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleItemType%40campusapi.org
- questionId: (string)
Id string to match question.
Example:
assessment.Question%3A7638%40base.url
- answerId: (string)
Id string to match answer.
Example:
assessment.Answer%3A22%40base.url
- learningObjectiveId: (string)
Id string to match learningObjective.
Example:
learning.Objective%3A4454%40base.url
- bankId: (string)
The id string to match a bank
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Item:297@base.url",
"uri": "http://base.url/open/campusapi/assessment/item/assessment.Item%3A297%40base.url",
"displayName": "Display Name of this Item",
"description": "The description of this Item",
"genusTypeId": "type.Type:defaultItemType@base.url",
"recordTypeIds": [ "type.Type:exampleItemRecordType@campusapi.org", "..."],
"learningObjectiveIds": [ "learning.Objective:2572@base.url", "..." ],
"questionId": "assessment.Question:7288@base.url",
"answerIds": [ "assessment.Answer:8724@base.url", "..." ]
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /items
Create a new Item in the default Bank.
Query Parameters
- genusType: (string)
specify a particular item type to create
Example:
type.Type%3AexampleItemType%40dxtera.org
- recordType: (array of )
specify support for one or more item record types
Example:
[ "type.Type%3AexampleItemRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this item
Example:
assessment.Bank%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Item",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this item, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this item, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this item for display.",
"type": "string"
},
"description": {
"description": "The description of this item.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this item. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this item. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"learningObjectiveIds": {
"description": "Any Objectives corresponding to this item.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
}
},
"questionId": {
"description": "The question.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"answerIds": {
"description": "The answers.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Item",
"description": "The description of this Item",
"learningObjectiveIds": [ "learning.Objective:2215@base.url", "..." ]
}
Query the collection of Items in a system, federation of systems, or in a default bank by posting a Query object.
Submit a query using a ItemQuery object.
post /items/item-query
Submit a query using a ItemQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "learningObjectives", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "ItemQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchLearningObjectiveIds": {
"description": "List of Objective Ids for this query to match learningObjectives.",
"type": "array",
"items": {
"type": "object",
"properties": {
"learningObjectiveId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"learningObjectiveQueries": {
"description": "learning.ObjectiveQueries to match the Learning Objectives. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyLearningObjective": {
"description": "Match learning objectives with any value. true to match Items with any learning objectives, false to match Items with no learning objectives",
"type": "boolean"
},
"matchBankIds": {
"description": "List of Bank Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"bankId": {
"description": "Bank id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"bankQueries": {
"description": "BankQueries to match Bank. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Item:297@base.url",
"uri": "http://base.url/open/campusapi/assessment/item/assessment.Item%3A297%40base.url",
"displayName": "Display Name of this Item",
"description": "The description of this Item",
"genusTypeId": "type.Type:defaultItemType@base.url",
"recordTypeIds": [ "type.Type:exampleItemRecordType@campusapi.org", "..."],
"learningObjectiveIds": [ "learning.Objective:2572@base.url", "..." ],
"questionId": "assessment.Question:7288@base.url",
"answerIds": [ "assessment.Answer:8724@base.url", "..." ]
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Item form metadata.
Get form metadata for creating a new Item.
get /items/metadata
Get form metadata for creating a new Item.
Query Parameters
- genusType: (string)
specify a particular item type to create
Example:
type.Type%3AexampleItemType%40dxtera.org
- recordType: (array of )
specify support for one or more item record types
Example:
[ "type.Type%3AexampleItemRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this item
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Item",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this item, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this item, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this item for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Item.Item:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this item",
"linked": false
},
"description": {
"description": "The description of this item.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Item.Item:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this item",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this item. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this item. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"learningObjectiveIds": {
"description": "Any Objectives corresponding to this item.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"elementId": "assessment.Item:learningObjectives@dxtera.org",
"existingValue": [],
"elementLabel": "Learning Objectives",
"instructions": "Enter Ids for learning objectives of this item.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Item
Get a particular Item given its id.
Update a particular Item given its id.
Delete a particular Item given its id.
get /items/{itemId}
Get a particular Item given its id.
URI Parameters
- itemId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "learningObjectives", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "assessment.Item:297@base.url",
"uri": "http://base.url/open/campusapi/assessment/item/assessment.Item%3A297%40base.url",
"displayName": "Display Name of this Item",
"description": "The description of this Item",
"genusTypeId": "type.Type:defaultItemType@base.url",
"recordTypeIds": [ "type.Type:exampleItemRecordType@campusapi.org", "..."],
"learningObjectiveIds": [ "learning.Objective:2572@base.url", "..." ],
"questionId": "assessment.Question:7288@base.url",
"answerIds": [ "assessment.Answer:8724@base.url", "..." ]
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Item not found" }
put /items/{itemId}
Update a particular Item given its id.
URI Parameters
- itemId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Item",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this item, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this item, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this item for display.",
"type": "string"
},
"description": {
"description": "The description of this item.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this item. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this item. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"learningObjectiveIds": {
"description": "Any Objectives corresponding to this item.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
}
},
"questionId": {
"description": "The question.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"answerIds": {
"description": "The answers.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Item",
"description": "The description of this Item",
"learningObjectiveIds": [ "learning.Objective:2215@base.url", "..." ]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Item has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Item not found" }
delete /items/{itemId}
Delete a particular Item given its id.
URI Parameters
- itemId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Item has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Item not found" }
Entity representing a Item form metadata for update
Get form metadata for updating an existing Item.
get /items/{itemId}/metadata
Get form metadata for updating an existing Item.
URI Parameters
- itemId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Item",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this item, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this item, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this item for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Item.Item:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this item",
"linked": false
},
"description": {
"description": "The description of this item.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Item.Item:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this item",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this item. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this item. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"learningObjectiveIds": {
"description": "Any Objectives corresponding to this item.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"elementId": "assessment.Item:learningObjectives@dxtera.org",
"existingValue": [],
"elementLabel": "Learning Objectives",
"instructions": "Enter Ids for learning objectives of this item.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "item not found" }
Collection of Questions in a system, federation of systems, or in a default Bank.
Get all Questions in the system or default Bank.
Create a new Question in the default Bank.
get /items/{itemId}/questions
Get all Questions in the system or default Bank.
URI Parameters
- itemId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Question:6391@base.url",
"uri": "http://base.url/open/campusapi/assessment/question/assessment.Question%3A6391%40base.url",
"displayName": "Display Name of this Question",
"description": "The description of this Question",
"genusTypeId": "type.Type:defaultQuestionType@base.url",
"recordTypeIds": [ "type.Type:exampleQuestionRecordType@campusapi.org", "..."]
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /items/{itemId}/questions
Create a new Question in the default Bank.
URI Parameters
- itemId: required(string)
Query Parameters
- genusType: (string)
specify a particular question type to create
Example:
type.Type%3AexampleQuestionType%40dxtera.org
- recordType: (array of )
specify support for one or more question record types
Example:
[ "type.Type%3AexampleQuestionRecordType%40campusapi.org", "..." ]
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Question",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this question, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this question, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this question for display.",
"type": "string"
},
"description": {
"description": "The description of this question.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this question. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this question. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Question",
"description": "The description of this Question"
}
Entity representing a Question form metadata.
Get form metadata for creating a new Question.
get /items/{itemId}/questions/metadata
Get form metadata for creating a new Question.
URI Parameters
- itemId: required(string)
Query Parameters
- genusType: (string)
specify a particular question type to create
Example:
type.Type%3AexampleQuestionType%40dxtera.org
- recordType: (array of )
specify support for one or more question record types
Example:
[ "type.Type%3AexampleQuestionRecordType%40campusapi.org", "..." ]
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Question",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this question, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this question, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this question for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Question.Question:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this question",
"linked": false
},
"description": {
"description": "The description of this question.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Question.Question:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this question",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this question. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this question. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Question
Get a particular Question given its id.
Update a particular Question given its id.
Delete a particular Question given its id.
get /items/{itemId}/questions/{questionId}
Get a particular Question given its id.
URI Parameters
- itemId: required(string)
- questionId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "assessment.Question:6391@base.url",
"uri": "http://base.url/open/campusapi/assessment/question/assessment.Question%3A6391%40base.url",
"displayName": "Display Name of this Question",
"description": "The description of this Question",
"genusTypeId": "type.Type:defaultQuestionType@base.url",
"recordTypeIds": [ "type.Type:exampleQuestionRecordType@campusapi.org", "..."]
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Question not found" }
put /items/{itemId}/questions/{questionId}
Update a particular Question given its id.
URI Parameters
- itemId: required(string)
- questionId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Question",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this question, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this question, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this question for display.",
"type": "string"
},
"description": {
"description": "The description of this question.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this question. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this question. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Question",
"description": "The description of this Question"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Question has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Question not found" }
delete /items/{itemId}/questions/{questionId}
Delete a particular Question given its id.
URI Parameters
- itemId: required(string)
- questionId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Question has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Question not found" }
Entity representing a Question form metadata for update
Get form metadata for updating an existing Question.
get /items/{itemId}/questions/{questionId}/metadata
Get form metadata for updating an existing Question.
URI Parameters
- itemId: required(string)
- questionId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Question",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this question, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this question, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this question for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Question.Question:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this question",
"linked": false
},
"description": {
"description": "The description of this question.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Question.Question:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this question",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this question. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this question. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "question not found" }
Collection of Answers in a system, federation of systems, or in a default Bank.
Get all Answers in the system or default Bank.
Create a new Answer in the default Bank.
get /items/{itemId}/answers
Get all Answers in the system or default Bank.
URI Parameters
- itemId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Answer:282@base.url",
"uri": "http://base.url/open/campusapi/assessment/answer/assessment.Answer%3A282%40base.url",
"displayName": "Display Name of this Answer",
"description": "The description of this Answer",
"genusTypeId": "type.Type:defaultAnswerType@base.url",
"recordTypeIds": [ "type.Type:exampleAnswerRecordType@campusapi.org", "..."]
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /items/{itemId}/answers
Create a new Answer in the default Bank.
URI Parameters
- itemId: required(string)
Query Parameters
- genusType: (string)
specify a particular answer type to create
Example:
type.Type%3AexampleAnswerType%40dxtera.org
- recordType: (array of )
specify support for one or more answer record types
Example:
[ "type.Type%3AexampleAnswerRecordType%40campusapi.org", "..." ]
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Answer",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this answer, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this answer, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this answer for display.",
"type": "string"
},
"description": {
"description": "The description of this answer.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this answer. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this answer. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Answer",
"description": "The description of this Answer"
}
Entity representing a Answer form metadata.
Get form metadata for creating a new Answer.
get /items/{itemId}/answers/metadata
Get form metadata for creating a new Answer.
URI Parameters
- itemId: required(string)
Query Parameters
- genusType: (string)
specify a particular answer type to create
Example:
type.Type%3AexampleAnswerType%40dxtera.org
- recordType: (array of )
specify support for one or more answer record types
Example:
[ "type.Type%3AexampleAnswerRecordType%40campusapi.org", "..." ]
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Answer",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this answer, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this answer, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this answer for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Answer.Answer:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this answer",
"linked": false
},
"description": {
"description": "The description of this answer.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Answer.Answer:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this answer",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this answer. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this answer. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Answer
Get a particular Answer given its id.
Update a particular Answer given its id.
Delete a particular Answer given its id.
get /items/{itemId}/answers/{answerId}
Get a particular Answer given its id.
URI Parameters
- itemId: required(string)
- answerId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "assessment.Answer:282@base.url",
"uri": "http://base.url/open/campusapi/assessment/answer/assessment.Answer%3A282%40base.url",
"displayName": "Display Name of this Answer",
"description": "The description of this Answer",
"genusTypeId": "type.Type:defaultAnswerType@base.url",
"recordTypeIds": [ "type.Type:exampleAnswerRecordType@campusapi.org", "..."]
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Answer not found" }
put /items/{itemId}/answers/{answerId}
Update a particular Answer given its id.
URI Parameters
- itemId: required(string)
- answerId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Answer",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this answer, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this answer, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this answer for display.",
"type": "string"
},
"description": {
"description": "The description of this answer.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this answer. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this answer. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Answer",
"description": "The description of this Answer"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Answer has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Answer not found" }
delete /items/{itemId}/answers/{answerId}
Delete a particular Answer given its id.
URI Parameters
- itemId: required(string)
- answerId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Answer has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Answer not found" }
Entity representing a Answer form metadata for update
Get form metadata for updating an existing Answer.
get /items/{itemId}/answers/{answerId}/metadata
Get form metadata for updating an existing Answer.
URI Parameters
- itemId: required(string)
- answerId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Answer",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this answer, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this answer, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this answer for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Answer.Answer:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this answer",
"linked": false
},
"description": {
"description": "The description of this answer.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Answer.Answer:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this answer",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this answer. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this answer. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "answer not found" }
/assessments
Collection of Assessments in a system, federation of systems, or in a default Bank.
Get all Assessments in the system or default Bank.
Create a new Assessment in the default Bank.
get /assessments
Get all Assessments in the system or default Bank.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentType%40campusapi.org
- bankId: (string)
The id string to match a bank
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Assessment:3491@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment/assessment.Assessment%3A3491%40base.url",
"displayName": "Display Name of this Assessment",
"description": "The description of this Assessment",
"genusTypeId": "type.Type:defaultAssessmentType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentRecordType@campusapi.org", "..."],
"levelId": "grading.Grade:4367@base.url",
"rubricId": "assessment.Assessment:1580@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /assessments
Create a new Assessment in the default Bank.
Query Parameters
- genusType: (string)
specify a particular assessment type to create
Example:
type.Type%3AexampleAssessmentType%40dxtera.org
- recordType: (array of )
specify support for one or more assessment record types
Example:
[ "type.Type%3AexampleAssessmentRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this assessment
Example:
assessment.Bank%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Assessment",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"format": "osid-id"
},
"rubricId": {
"description": "The rubric.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this Assessment",
"description": "The description of this Assessment",
"levelId": "grading.Grade:7939@base.url",
"rubricId": "assessment.Assessment:8725@base.url"
}
Query the collection of Assessments in a system, federation of systems, or in a default bank by posting a Query object.
Submit a query using a AssessmentQuery object.
post /assessments/assessment-query
Submit a query using a AssessmentQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchLevelIds": {
"description": "List of Grade Ids for this query to match level.",
"type": "array",
"items": {
"type": "object",
"properties": {
"levelId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"levelQueries": {
"description": "grading.GradeQueries to match the Level. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyLevel": {
"description": "Match level with any value. true to match Assessments with any level, false to match Assessments with no level",
"type": "boolean"
},
"matchRubricIds": {
"description": "List of Assessment Ids for this query to match rubric.",
"type": "array",
"items": {
"type": "object",
"properties": {
"rubricId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"rubricQueries": {
"description": "assessment.AssessmentQueries to match the Rubric. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyRubric": {
"description": "Match rubric with any value. true to match Assessments with any rubric, false to match Assessments with no rubric",
"type": "boolean"
},
"matchBankIds": {
"description": "List of Bank Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"bankId": {
"description": "Bank id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"bankQueries": {
"description": "BankQueries to match Bank. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Assessment:3491@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment/assessment.Assessment%3A3491%40base.url",
"displayName": "Display Name of this Assessment",
"description": "The description of this Assessment",
"genusTypeId": "type.Type:defaultAssessmentType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentRecordType@campusapi.org", "..."],
"levelId": "grading.Grade:4367@base.url",
"rubricId": "assessment.Assessment:1580@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Assessment form metadata.
Get form metadata for creating a new Assessment.
get /assessments/metadata
Get form metadata for creating a new Assessment.
Query Parameters
- genusType: (string)
specify a particular assessment type to create
Example:
type.Type%3AexampleAssessmentType%40dxtera.org
- recordType: (array of )
specify support for one or more assessment record types
Example:
[ "type.Type%3AexampleAssessmentRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this assessment
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Assessment",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Assessment.Assessment:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment",
"linked": false
},
"description": {
"description": "The description of this assessment.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Assessment.Assessment:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.Assessment:level@dxtera.org",
"existingValue": null,
"elementLabel": "Level",
"instructions": "Enter the Id of the level for this assessment.",
"linked": false
},
"rubricId": {
"description": "The rubric.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.Assessment:rubric@dxtera.org",
"existingValue": null,
"elementLabel": "Rubric",
"instructions": "Enter the Id of the rubric for this assessment.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Assessment
Get a particular Assessment given its id.
Update a particular Assessment given its id.
Delete a particular Assessment given its id.
get /assessments/{assessmentId}
Get a particular Assessment given its id.
URI Parameters
- assessmentId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "assessment.Assessment:3491@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment/assessment.Assessment%3A3491%40base.url",
"displayName": "Display Name of this Assessment",
"description": "The description of this Assessment",
"genusTypeId": "type.Type:defaultAssessmentType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentRecordType@campusapi.org", "..."],
"levelId": "grading.Grade:4367@base.url",
"rubricId": "assessment.Assessment:1580@base.url"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Assessment not found" }
put /assessments/{assessmentId}
Update a particular Assessment given its id.
URI Parameters
- assessmentId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Assessment",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"format": "osid-id"
},
"rubricId": {
"description": "The rubric.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this Assessment",
"description": "The description of this Assessment",
"levelId": "grading.Grade:7939@base.url",
"rubricId": "assessment.Assessment:8725@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Assessment has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Assessment not found" }
delete /assessments/{assessmentId}
Delete a particular Assessment given its id.
URI Parameters
- assessmentId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Assessment has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Assessment not found" }
Entity representing a Assessment form metadata for update
Get form metadata for updating an existing Assessment.
get /assessments/{assessmentId}/metadata
Get form metadata for updating an existing Assessment.
URI Parameters
- assessmentId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Assessment",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Assessment.Assessment:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment",
"linked": false
},
"description": {
"description": "The description of this assessment.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Assessment.Assessment:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.Assessment:level@dxtera.org",
"existingValue": null,
"elementLabel": "Level",
"instructions": "Enter the Id of the level for this assessment.",
"linked": false
},
"rubricId": {
"description": "The rubric.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.Assessment:rubric@dxtera.org",
"existingValue": null,
"elementLabel": "Rubric",
"instructions": "Enter the Id of the rubric for this assessment.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "assessment not found" }
/assessments-offered
Collection of AssessmentsOffered in a system, federation of systems, or in a default Bank.
Get all AssessmentsOffered in the system or default Bank.
Create a new AssessmentsOffered in the default Bank.
get /assessments-offered
Get all AssessmentsOffered in the system or default Bank.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "scoreSystem", "gradeSystem", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentOfferedType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentOfferedType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentOfferedType%40campusapi.org
- assessmentId: (string)
the id string to match a assessment.
Example:
assessment.Assessment%3A1700%40base.url
- fromDate: (string)
Get all assessments-offered from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all assessments-offered up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- bankId: (string)
The id string to match a bank
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.AssessmentOffered:1388@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_offered/assessment.AssessmentOffered%3A1388%40base.url",
"displayName": "Display Name of this AssessmentOffered",
"description": "The description of this AssessmentOffered",
"genusTypeId": "type.Type:defaultAssessmentOfferedType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentOfferedRecordType@campusapi.org", "..."],
"assessmentId": "assessment.Assessment:8819@base.url",
"levelId": "grading.Grade:2180@base.url",
"itemsSequential": true,
"itemsShuffled": true,
"startTime": "2020-10-03T08:00:00.000Z",
"deadline": "2021-07-21T23:15:30.123Z",
"duration": "P3DT3H",
"scoreSystemId": "grading.GradeSystem:2781@base.url",
"gradeSystemId": "grading.GradeSystem:2729@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /assessments-offered
Create a new AssessmentsOffered in the default Bank.
Query Parameters
- assessmentId: required(string)
the assessment of this assessments-offered.
Example:
assessment.Assessment%3A1700%40base.url
- genusType: (string)
specify a particular assessmentOffered type to create
Example:
type.Type%3AexampleAssessmentOfferedType%40dxtera.org
- recordType: (array of )
specify support for one or more assessmentOffered record types
Example:
[ "type.Type%3AexampleAssessmentOfferedRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this assessmentOffered
Example:
assessment.Bank%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentOffered",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment offered, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment offered, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment offered for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment offered.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment offered. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment offered. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"assessmentId": {
"description": "The assessment associated with this assessment offered.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"format": "osid-id"
},
"itemsSequential": {
"description": "Tests if the items or parts in this assessment are taken sequentially.",
"type": "boolean"
},
"itemsShuffled": {
"description": "Tests if the items or parts appear in a random order.",
"type": "boolean"
},
"startTime": {
"description": "The start time for this assessment.",
"type": "string",
"format": "date-time"
},
"deadline": {
"description": "The end time for this assessment.",
"type": "string",
"format": "date-time"
},
"duration": {
"description": "The duration for this assessment.",
"type": "string",
"format": "duration"
},
"scoreSystemId": {
"description": "The grade system for the score.",
"type": "string",
"format": "osid-id"
},
"gradeSystemId": {
"description": "The grade system for the grade.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this AssessmentOffered",
"description": "The description of this AssessmentOffered",
"levelId": "grading.Grade:6032@base.url",
"itemsSequential": true,
"itemsShuffled": true,
"startTime": "2020-10-03T08:00:00.000Z",
"deadline": "2021-07-21T23:15:30.123Z",
"duration": "P3DT3H",
"scoreSystemId": "grading.GradeSystem:5552@base.url",
"gradeSystemId": "grading.GradeSystem:5576@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentsOffered has been created",
"assessments-offeredId": "assessment.AssessmentsOffered:9876@demo.dxtera.org"}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Query the collection of AssessmentOffereds in a system, federation of systems, or in a default bank by posting a Query object.
Submit a query using a AssessmentOfferedQuery object.
post /assessments-offered/assessment-offered-query
Submit a query using a AssessmentOfferedQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "scoreSystem", "gradeSystem", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentOfferedQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAssessmentIds": {
"description": "List of assessment Ids for this query to match assessment offered that have a related assessment.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"assessmentQueries": {
"description": "AssessmentQueries to match the assessment. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchLevelIds": {
"description": "List of Grade Ids for this query to match level.",
"type": "array",
"items": {
"type": "object",
"properties": {
"levelId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"levelQueries": {
"description": "grading.GradeQueries to match the Level. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyLevel": {
"description": "Match level with any value. true to match AssessmentsOffered with any level, false to match AssessmentsOffered with no level",
"type": "boolean"
},
"matchItemsSequential": {
"description": "Match boolean value for itemsSequential.",
"type": "object",
"properties": {
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
},
"matchItemsShuffled": {
"description": "Match boolean value for itemsShuffled.",
"type": "object",
"properties": {
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
},
"matchStartTime": {
"description": "Matches startTimes between the given date range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"low": {
"description": "low date range",
"type": "string",
"format": "date-time"
},
"high": {
"description": "high date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyStartTime": {
"description": "Match startTimes with any value. true to match AssessmentsOffered with any start time, false to match ProgramOfferings with no start time",
"type": "boolean"
},
"matchDeadline": {
"description": "Matches deadlines between the given date range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"low": {
"description": "low date range",
"type": "string",
"format": "date-time"
},
"high": {
"description": "high date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyDeadline": {
"description": "Match deadlines with any value. true to match AssessmentsOffered with any deadline, false to match ProgramOfferings with no deadline",
"type": "boolean"
},
"matchDuration": {
"description": "Matches durations in the given range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"description": "start range",
"type": "string",
"format": "duration"
},
"to": {
"description": "end range",
"type": "string",
"format": "duration"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyDuration": {
"description": "Match durations with any value. true to match AssessmentsOffered with any duration, false to match ProgramOfferings with no duration",
"type": "boolean"
},
"matchScoreSystemIds": {
"description": "List of GradeSystem Ids for this query to match scoreSystem.",
"type": "array",
"items": {
"type": "object",
"properties": {
"scoreSystemId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"scoreSystemQueries": {
"description": "grading.GradeSystemQueries to match the Score System. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyScoreSystem": {
"description": "Match score system with any value. true to match AssessmentsOffered with any score system, false to match AssessmentsOffered with no score system",
"type": "boolean"
},
"matchGradeSystemIds": {
"description": "List of GradeSystem Ids for this query to match gradeSystem.",
"type": "array",
"items": {
"type": "object",
"properties": {
"gradeSystemId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"gradeSystemQueries": {
"description": "grading.GradeSystemQueries to match the Grade System. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyGradeSystem": {
"description": "Match grade system with any value. true to match AssessmentsOffered with any grade system, false to match AssessmentsOffered with no grade system",
"type": "boolean"
},
"matchBankIds": {
"description": "List of Bank Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"bankId": {
"description": "Bank id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"bankQueries": {
"description": "BankQueries to match Bank. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.AssessmentOffered:1388@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_offered/assessment.AssessmentOffered%3A1388%40base.url",
"displayName": "Display Name of this AssessmentOffered",
"description": "The description of this AssessmentOffered",
"genusTypeId": "type.Type:defaultAssessmentOfferedType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentOfferedRecordType@campusapi.org", "..."],
"assessmentId": "assessment.Assessment:8819@base.url",
"levelId": "grading.Grade:2180@base.url",
"itemsSequential": true,
"itemsShuffled": true,
"startTime": "2020-10-03T08:00:00.000Z",
"deadline": "2021-07-21T23:15:30.123Z",
"duration": "P3DT3H",
"scoreSystemId": "grading.GradeSystem:2781@base.url",
"gradeSystemId": "grading.GradeSystem:2729@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AssessmentOffered form metadata.
Get form metadata for creating a new AssessmentOffered.
get /assessments-offered/metadata
Get form metadata for creating a new AssessmentOffered.
Query Parameters
- assessmentId: required(string)
the assessment of this metadatum.
Example:
assessment.Assessment%3A1700%40base.url
- genusType: (string)
specify a particular assessmentOffered type to create
Example:
type.Type%3AexampleAssessmentOfferedType%40dxtera.org
- recordType: (array of )
specify support for one or more assessmentOffered record types
Example:
[ "type.Type%3AexampleAssessmentOfferedRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this assessmentOffered
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AssessmentOffered",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment offered, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment offered, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment offered for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentOffered.AssessmentOffered:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment offered",
"linked": false
},
"description": {
"description": "The description of this assessment offered.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentOffered.AssessmentOffered:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment offered",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment offered. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment offered. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:level@dxtera.org",
"existingValue": null,
"elementLabel": "Level",
"instructions": "Enter the Id of the level for this assessment offered.",
"linked": false
},
"itemsSequential": {
"description": "Tests if the items or parts in this assessment are taken sequentially.",
"type": "boolean",
"elementId": "assessment.AssessmentOffered:itemsSequential@dxtera.org",
"existingValue": false,
"elementLabel": "Items Sequential",
"instructions": "Enter true or false.",
"linked": false
},
"itemsShuffled": {
"description": "Tests if the items or parts appear in a random order.",
"type": "boolean",
"elementId": "assessment.AssessmentOffered:itemsShuffled@dxtera.org",
"existingValue": false,
"elementLabel": "Items Shuffled",
"instructions": "Enter true or false.",
"linked": false
},
"startTime": {
"description": "The start time for this assessment.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:startTime@dxtera.org",
"existingValue": "",
"elementLabel": "Start Time",
"instructions": "Enter the start time of this assessment offered.",
"linked": false
},
"deadline": {
"description": "The end time for this assessment.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:deadline@dxtera.org",
"existingValue": "",
"elementLabel": "Deadline",
"instructions": "Enter the deadline of this assessment offered.",
"linked": false
},
"duration": {
"description": "The duration for this assessment.",
"type": "string",
"format": "duration",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:duration@dxtera.org",
"existingValue": "",
"elementLabel": "Duration",
"instructions": "Enter the duration of this assessment offered.",
"linked": false
},
"scoreSystemId": {
"description": "The grade system for the score.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:scoreSystem@dxtera.org",
"existingValue": null,
"elementLabel": "Score System",
"instructions": "Enter the Id of the score system for this assessment offered.",
"linked": false
},
"gradeSystemId": {
"description": "The grade system for the grade.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:gradeSystem@dxtera.org",
"existingValue": null,
"elementLabel": "Grade System",
"instructions": "Enter the Id of the grade system for this assessment offered.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AssessmentsOffered
Get a particular AssessmentsOffered given its id.
Update a particular AssessmentsOffered given its id.
Delete a particular AssessmentsOffered given its id.
get /assessments-offered/{assessmentOfferedId}
Get a particular AssessmentsOffered given its id.
URI Parameters
- assessmentOfferedId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "scoreSystem", "gradeSystem", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "assessment.AssessmentOffered:1388@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_offered/assessment.AssessmentOffered%3A1388%40base.url",
"displayName": "Display Name of this AssessmentOffered",
"description": "The description of this AssessmentOffered",
"genusTypeId": "type.Type:defaultAssessmentOfferedType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentOfferedRecordType@campusapi.org", "..."],
"assessmentId": "assessment.Assessment:8819@base.url",
"levelId": "grading.Grade:2180@base.url",
"itemsSequential": true,
"itemsShuffled": true,
"startTime": "2020-10-03T08:00:00.000Z",
"deadline": "2021-07-21T23:15:30.123Z",
"duration": "P3DT3H",
"scoreSystemId": "grading.GradeSystem:2781@base.url",
"gradeSystemId": "grading.GradeSystem:2729@base.url"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentsOffered not found" }
put /assessments-offered/{assessmentOfferedId}
Update a particular AssessmentsOffered given its id.
URI Parameters
- assessmentOfferedId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentOffered",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment offered, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment offered, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment offered for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment offered.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment offered. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment offered. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"assessmentId": {
"description": "The assessment associated with this assessment offered.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"format": "osid-id"
},
"itemsSequential": {
"description": "Tests if the items or parts in this assessment are taken sequentially.",
"type": "boolean"
},
"itemsShuffled": {
"description": "Tests if the items or parts appear in a random order.",
"type": "boolean"
},
"startTime": {
"description": "The start time for this assessment.",
"type": "string",
"format": "date-time"
},
"deadline": {
"description": "The end time for this assessment.",
"type": "string",
"format": "date-time"
},
"duration": {
"description": "The duration for this assessment.",
"type": "string",
"format": "duration"
},
"scoreSystemId": {
"description": "The grade system for the score.",
"type": "string",
"format": "osid-id"
},
"gradeSystemId": {
"description": "The grade system for the grade.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this AssessmentOffered",
"description": "The description of this AssessmentOffered",
"levelId": "grading.Grade:6032@base.url",
"itemsSequential": true,
"itemsShuffled": true,
"startTime": "2020-10-03T08:00:00.000Z",
"deadline": "2021-07-21T23:15:30.123Z",
"duration": "P3DT3H",
"scoreSystemId": "grading.GradeSystem:5552@base.url",
"gradeSystemId": "grading.GradeSystem:5576@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentsOffered has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentsOffered not found" }
delete /assessments-offered/{assessmentOfferedId}
Delete a particular AssessmentsOffered given its id.
URI Parameters
- assessmentOfferedId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentsOffered has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentsOffered not found" }
Entity representing a AssessmentOffered form metadata for update
Get form metadata for updating an existing AssessmentOffered.
get /assessments-offered/{assessmentOfferedId}/metadata
Get form metadata for updating an existing AssessmentOffered.
URI Parameters
- assessmentOfferedId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AssessmentOffered",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment offered, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment offered, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment offered for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentOffered.AssessmentOffered:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment offered",
"linked": false
},
"description": {
"description": "The description of this assessment offered.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentOffered.AssessmentOffered:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment offered",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment offered. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment offered. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"levelId": {
"description": "The Grade corresponding to the assessment difficulty.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:level@dxtera.org",
"existingValue": null,
"elementLabel": "Level",
"instructions": "Enter the Id of the level for this assessment offered.",
"linked": false
},
"itemsSequential": {
"description": "Tests if the items or parts in this assessment are taken sequentially.",
"type": "boolean",
"elementId": "assessment.AssessmentOffered:itemsSequential@dxtera.org",
"existingValue": false,
"elementLabel": "Items Sequential",
"instructions": "Enter true or false.",
"linked": false
},
"itemsShuffled": {
"description": "Tests if the items or parts appear in a random order.",
"type": "boolean",
"elementId": "assessment.AssessmentOffered:itemsShuffled@dxtera.org",
"existingValue": false,
"elementLabel": "Items Shuffled",
"instructions": "Enter true or false.",
"linked": false
},
"startTime": {
"description": "The start time for this assessment.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:startTime@dxtera.org",
"existingValue": "",
"elementLabel": "Start Time",
"instructions": "Enter the start time of this assessment offered.",
"linked": false
},
"deadline": {
"description": "The end time for this assessment.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:deadline@dxtera.org",
"existingValue": "",
"elementLabel": "Deadline",
"instructions": "Enter the deadline of this assessment offered.",
"linked": false
},
"duration": {
"description": "The duration for this assessment.",
"type": "string",
"format": "duration",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:duration@dxtera.org",
"existingValue": "",
"elementLabel": "Duration",
"instructions": "Enter the duration of this assessment offered.",
"linked": false
},
"scoreSystemId": {
"description": "The grade system for the score.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:scoreSystem@dxtera.org",
"existingValue": null,
"elementLabel": "Score System",
"instructions": "Enter the Id of the score system for this assessment offered.",
"linked": false
},
"gradeSystemId": {
"description": "The grade system for the grade.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentOffered:gradeSystem@dxtera.org",
"existingValue": null,
"elementLabel": "Grade System",
"instructions": "Enter the Id of the grade system for this assessment offered.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "assessmentOffered not found" }
/assessments-taken
Collection of AssessmentsTaken in a system, federation of systems, or in a default Bank.
Get all AssessmentsTaken in the system or default Bank.
Create a new AssessmentsTaken in the default Bank.
get /assessments-taken
Get all AssessmentsTaken in the system or default Bank.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "taker", "assessmentOffered", "takingAgent", "scoreSystem", "grade", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentTakenType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentTakenType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentTakenType%40campusapi.org
- takerId: (string)
the id string to match a taker.
Example:
resource.Resource%3A600%40base.url
- takingAgentId: (string)
the id string to match a taking-agent.
Example:
authentication.Agent%3A2520%40base.url
- actualStartTimeId: (string)
the id string to match a actual-start-time.
Example:
calendaring.DateTime%3A2805%40base.url
- assessmentOfferedId: (string)
the id string to match a assessment-offered.
Example:
assessment.AssessmentOffered%3A2700%40base.url
- assessmentId: (string)
Id string to match assessment.
Example:
assessment.Assessment%3A7836%40base.url
- bankId: (string)
The id string to match a bank
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.AssessmentTaken:9503@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_taken/assessment.AssessmentTaken%3A9503%40base.url",
"displayName": "Display Name of this AssessmentTaken",
"description": "The description of this AssessmentTaken",
"genusTypeId": "type.Type:defaultAssessmentTakenType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentTakenRecordType@campusapi.org", "..."],
"takerId": "resource.Resource:9031@base.url",
"takingAgentId": "authentication.Agent:5255@base.url",
"actualStartTime": "2020-10-03T08:00:00.000Z",
"assessmentOfferedId": "assessment.AssessmentOffered:1709@base.url",
"completionTime": "2021-07-21T23:15:30.000Z",
"scoreSystemId": "grading.GradeSystem:642@base.url",
"score": 3.14,
"gradeId": "grading.Grade:6662@base.url",
"feedback": "This is the Feedback",
"rubricId": "assessment.AssessmentTaken:1200@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /assessments-taken
Create a new AssessmentsTaken in the default Bank.
Query Parameters
- takerId: required(string)
the taker of this assessments-taken.
Example:
resource.Resource%3A600%40base.url
- takingAgentId: required(string)
the taking-agent of this assessments-taken.
Example:
authentication.Agent%3A2520%40base.url
- actualStartTimeId: required(string)
the actual-start-time of this assessments-taken.
Example:
calendaring.DateTime%3A2805%40base.url
- assessmentOfferedId: required(string)
the assessment-offered of this assessments-taken.
Example:
assessment.AssessmentOffered%3A2700%40base.url
- genusType: (string)
specify a particular assessmentTaken type to create
Example:
type.Type%3AexampleAssessmentTakenType%40dxtera.org
- recordType: (array of )
specify support for one or more assessmentTaken record types
Example:
[ "type.Type%3AexampleAssessmentTakenRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this assessmentTaken
Example:
assessment.Bank%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentTaken",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment taken, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment taken, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment taken for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment taken.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment taken. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment taken. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"takerId": {
"description": "The taker associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"takingAgentId": {
"description": "The taking agent associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"actualStartTimeId": {
"description": "The actual start time associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"assessmentOfferedId": {
"description": "The assessment offered associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"takerId": {
"description": "The Resource taking this assessment.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this AssessmentTaken",
"description": "The description of this AssessmentTaken",
"completionTime": "2021-07-21T23:15:30.000Z",
"scoreSystemId": "grading.GradeSystem:9273@base.url",
"score": 3.14,
"gradeId": "grading.Grade:1340@base.url",
"feedback": "This is the Feedback",
"rubricId": "assessment.AssessmentTaken:4371@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentsTaken has been created",
"assessments-takenId": "assessment.AssessmentsTaken:9876@demo.dxtera.org"}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Query the collection of AssessmentTakens in a system, federation of systems, or in a default bank by posting a Query object.
Submit a query using a AssessmentTakenQuery object.
post /assessments-taken/assessment-taken-query
Submit a query using a AssessmentTakenQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "taker", "assessmentOffered", "takingAgent", "scoreSystem", "grade", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentTakenQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchTakerIds": {
"description": "List of taker Ids for this query to match assessment taken that have a related taker.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"takerQueries": {
"description": "TakerQueries to match the taker. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchTakingAgentIds": {
"description": "List of takingAgent Ids for this query to match assessment taken that have a related takingAgent.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"takingAgentQueries": {
"description": "TakingAgentQueries to match the takingAgent. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchActualStartTimeIds": {
"description": "List of actualStartTime Ids for this query to match assessment taken that have a related actualStartTime.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"actualStartTimeQueries": {
"description": "ActualStartTimeQueries to match the actualStartTime. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAssessmentOfferedIds": {
"description": "List of assessmentOffered Ids for this query to match assessment taken that have a related assessmentOffered.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"assessmentOfferedQueries": {
"description": "AssessmentOfferedQueries to match the assessmentOffered. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchTakerIds": {
"description": "List of Resource Ids for this query to match taker.",
"type": "array",
"items": {
"type": "object",
"properties": {
"takerId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"takerQueries": {
"description": "resource.ResourceQueries to match the Taker. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyTaker": {
"description": "Match taker with any value. true to match AssessmentsTaken with any taker, false to match AssessmentsTaken with no taker",
"type": "boolean"
},
"matchBankIds": {
"description": "List of Bank Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"bankId": {
"description": "Bank id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"bankQueries": {
"description": "BankQueries to match Bank. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.AssessmentTaken:9503@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_taken/assessment.AssessmentTaken%3A9503%40base.url",
"displayName": "Display Name of this AssessmentTaken",
"description": "The description of this AssessmentTaken",
"genusTypeId": "type.Type:defaultAssessmentTakenType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentTakenRecordType@campusapi.org", "..."],
"takerId": "resource.Resource:9031@base.url",
"takingAgentId": "authentication.Agent:5255@base.url",
"actualStartTime": "2020-10-03T08:00:00.000Z",
"assessmentOfferedId": "assessment.AssessmentOffered:1709@base.url",
"completionTime": "2021-07-21T23:15:30.000Z",
"scoreSystemId": "grading.GradeSystem:642@base.url",
"score": 3.14,
"gradeId": "grading.Grade:6662@base.url",
"feedback": "This is the Feedback",
"rubricId": "assessment.AssessmentTaken:1200@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AssessmentTaken form metadata.
Get form metadata for creating a new AssessmentTaken.
get /assessments-taken/metadata
Get form metadata for creating a new AssessmentTaken.
Query Parameters
- takerId: required(string)
the taker of this metadatum.
Example:
resource.Resource%3A600%40base.url
- takingAgentId: required(string)
the taking-agent of this metadatum.
Example:
authentication.Agent%3A2520%40base.url
- actualStartTimeId: required(string)
the actual-start-time of this metadatum.
Example:
calendaring.DateTime%3A2805%40base.url
- assessmentOfferedId: required(string)
the assessment-offered of this metadatum.
Example:
assessment.AssessmentOffered%3A2700%40base.url
- genusType: (string)
specify a particular assessmentTaken type to create
Example:
type.Type%3AexampleAssessmentTakenType%40dxtera.org
- recordType: (array of )
specify support for one or more assessmentTaken record types
Example:
[ "type.Type%3AexampleAssessmentTakenRecordType%40campusapi.org", "..." ]
- bankId: (string)
specify in which bank to create this assessmentTaken
Example:
assessment.Bank%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AssessmentTaken",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment taken, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment taken, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment taken for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentTaken.AssessmentTaken:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment taken",
"linked": false
},
"description": {
"description": "The description of this assessment taken.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentTaken.AssessmentTaken:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment taken",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment taken. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment taken. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"takerId": {
"description": "The Resource taking this assessment.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentTaken:taker@dxtera.org",
"existingValue": null,
"elementLabel": "Taker",
"instructions": "Enter the Id of the taker for this assessment taken.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AssessmentsTaken
Get a particular AssessmentsTaken given its id.
Update a particular AssessmentsTaken given its id.
Delete a particular AssessmentsTaken given its id.
get /assessments-taken/{assessmentTakenId}
Get a particular AssessmentsTaken given its id.
URI Parameters
- assessmentTakenId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "taker", "assessmentOffered", "takingAgent", "scoreSystem", "grade", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "assessment.AssessmentTaken:9503@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_taken/assessment.AssessmentTaken%3A9503%40base.url",
"displayName": "Display Name of this AssessmentTaken",
"description": "The description of this AssessmentTaken",
"genusTypeId": "type.Type:defaultAssessmentTakenType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentTakenRecordType@campusapi.org", "..."],
"takerId": "resource.Resource:9031@base.url",
"takingAgentId": "authentication.Agent:5255@base.url",
"actualStartTime": "2020-10-03T08:00:00.000Z",
"assessmentOfferedId": "assessment.AssessmentOffered:1709@base.url",
"completionTime": "2021-07-21T23:15:30.000Z",
"scoreSystemId": "grading.GradeSystem:642@base.url",
"score": 3.14,
"gradeId": "grading.Grade:6662@base.url",
"feedback": "This is the Feedback",
"rubricId": "assessment.AssessmentTaken:1200@base.url"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentsTaken not found" }
put /assessments-taken/{assessmentTakenId}
Update a particular AssessmentsTaken given its id.
URI Parameters
- assessmentTakenId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentTaken",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment taken, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment taken, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment taken for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment taken.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment taken. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment taken. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"takerId": {
"description": "The taker associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"takingAgentId": {
"description": "The taking agent associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"actualStartTimeId": {
"description": "The actual start time associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"assessmentOfferedId": {
"description": "The assessment offered associated with this assessment taken.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"takerId": {
"description": "The Resource taking this assessment.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this AssessmentTaken",
"description": "The description of this AssessmentTaken",
"completionTime": "2021-07-21T23:15:30.000Z",
"scoreSystemId": "grading.GradeSystem:9273@base.url",
"score": 3.14,
"gradeId": "grading.Grade:1340@base.url",
"feedback": "This is the Feedback",
"rubricId": "assessment.AssessmentTaken:4371@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentsTaken has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentsTaken not found" }
delete /assessments-taken/{assessmentTakenId}
Delete a particular AssessmentsTaken given its id.
URI Parameters
- assessmentTakenId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentsTaken has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentsTaken not found" }
Entity representing a AssessmentTaken form metadata for update
Get form metadata for updating an existing AssessmentTaken.
get /assessments-taken/{assessmentTakenId}/metadata
Get form metadata for updating an existing AssessmentTaken.
URI Parameters
- assessmentTakenId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AssessmentTaken",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment taken, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment taken, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment taken for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentTaken.AssessmentTaken:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment taken",
"linked": false
},
"description": {
"description": "The description of this assessment taken.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentTaken.AssessmentTaken:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment taken",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment taken. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment taken. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"takerId": {
"description": "The Resource taking this assessment.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "assessment.AssessmentTaken:taker@dxtera.org",
"existingValue": null,
"elementLabel": "Taker",
"instructions": "Enter the Id of the taker for this assessment taken.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "assessmentTaken not found" }
/banks
Collection of Banks in a system or federation of systems.
Get all Banks.
Create a new Bank.
get /banks
Get all Banks.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "provider", "branding", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleBankType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleBankType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleBankType%40campusapi.org
- providerId: (string)
Id string to match provider.
Example:
resource.Resource%3A3007%40demo.dxtera.org
- questionId: (string)
Get banks mapped to this question.
Example:
assessment.Question%3A320%40demo.dxtera.org
- answerId: (string)
Get banks mapped to this answer.
Example:
assessment.Answer%3A240%40demo.dxtera.org
- itemId: (string)
Get banks mapped to this item.
Example:
assessment.Item%3A160%40demo.dxtera.org
- assessmentId: (string)
Get banks mapped to this assessment.
Example:
assessment.Assessment%3A400%40demo.dxtera.org
- assessmentOfferedId: (string)
Get banks mapped to this assessment-offered.
Example:
assessment.AssessmentOffered%3A720%40demo.dxtera.org
- assessmentTakenId: (string)
Get banks mapped to this assessment-taken.
Example:
assessment.AssessmentTaken%3A640%40demo.dxtera.org
- assessmentSectionId: (string)
Get banks mapped to this assessment-section.
Example:
assessment.AssessmentSection%3A720%40demo.dxtera.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Bank:239@base.url",
"uri": "http://base.url/open/campusapi/assessment/bank/assessment.Bank%3A239%40base.url",
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"genusTypeId": "type.Type:defaultBankType@base.url",
"recordTypeIds": [ "type.Type:exampleBankRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /banks
Create a new Bank.
Query Parameters
- genusType: (string)
specify a particular bank type to create
Example:
type.Type%3AexampleBankType%40dxtera.org
- recordType: (array of )
specify support for one or more bank record types
Example:
[ "type.Type%3AexampleBankRecordType%40campusapi.org", "..." ]
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Bank",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this bank, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this bank, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this bank for display.",
"type": "string"
},
"description": {
"description": "The description of this bank.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this bank. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this bank. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this bank.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this bank. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this bank.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
}
Query the collection of Banks in a system, federation of systems, or in a default bank by posting a Query object.
Submit a query using a BankQuery object.
post /banks/bank-query
Submit a query using a BankQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "BankQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchProviderIds": {
"description": "List of provider Ids to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"providerQueries": {
"description": "resource.ResourceQuery for provider. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
},
"matchAnyProvider": {
"description": "Match providers with any value. true to match Bank with any provider, false to match Bank with no provider",
"type": "boolean"
}
},
"matchBrandingIds": {
"description": "List of branding asset Ids to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"brandingQueries": {
"description": "repository.AssetQuery for branding. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyBranding": {
"description": "Match brandingss with any value. true to match Bank with any branding, false to match Bank with no branding",
"type": "boolean"
},
"matchlicenses": {
"description": "List of license strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"license": {
"description": "license to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchBankIds": {
"description": "List of Bank Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"bankId": {
"description": "Bank id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"bankQueries": {
"description": "BankQueries to match Bank. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Bank:239@base.url",
"uri": "http://base.url/open/campusapi/assessment/bank/assessment.Bank%3A239%40base.url",
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"genusTypeId": "type.Type:defaultBankType@base.url",
"recordTypeIds": [ "type.Type:exampleBankRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Bank form metadata.
Get form metadata for creating a new Bank.
get /banks/metadata
Get form metadata for creating a new Bank.
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Bank",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this bank, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this bank, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this bank for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this bank",
"linked": false
},
"description": {
"description": "The description of this bank.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this bank",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this bank. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this bank. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this bank.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this bank",
"linked": false
},
"brandingIds": {
"description": "The branding of this bank. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "Bank.Bank:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this bank",
"linked": false
},
"license": {
"description": "The licensing that applies to this bank.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this bank",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
The root Banks in the Bank hierarchy. A node with no parents is an orphan. While all Bank Ids are known to the hierarchy, an orphan does not appear in the hierarchy unless explicitly added as a root node or child of another node.
Get all root root-bank
get /banks/root-bank
Get all root root-bank
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Bank:239@base.url",
"uri": "http://base.url/open/campusapi/assessment/bank/assessment.Bank%3A239%40base.url",
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"genusTypeId": "type.Type:defaultBankType@base.url",
"recordTypeIds": [ "type.Type:exampleBankRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Bank
Get a particular Bank given its id.
Update a particular Bank given its id.
Delete a particular Bank given its id.
get /banks/{bankId}
Get a particular Bank given its id.
URI Parameters
- bankId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "assessment.Bank:239@base.url",
"uri": "http://base.url/open/campusapi/assessment/bank/assessment.Bank%3A239%40base.url",
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"genusTypeId": "type.Type:defaultBankType@base.url",
"recordTypeIds": [ "type.Type:exampleBankRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Bank not found" }
put /banks/{bankId}
Update a particular Bank given its id.
URI Parameters
- bankId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Bank",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this bank, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this bank, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this bank for display.",
"type": "string"
},
"description": {
"description": "The description of this bank.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this bank. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this bank. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this bank.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this bank. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this bank.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Bank has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Bank not found" }
delete /banks/{bankId}
Delete a particular Bank given its id.
URI Parameters
- bankId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Bank has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Bank not found" }
Entity representing a Bank form metadata for update
Get form metadata for updating an existing Bank.
get /banks/{bankId}/metadata
Get form metadata for updating an existing Bank.
URI Parameters
- bankId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Bank",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this bank, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this bank, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this bank for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this bank",
"linked": false
},
"description": {
"description": "The description of this bank.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this bank",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this bank. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this bank. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this bank.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this bank",
"linked": false
},
"brandingIds": {
"description": "The branding of this bank. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "Bank.Bank:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this bank",
"linked": false
},
"license": {
"description": "The licensing that applies to this bank.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Bank.Bank:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this bank",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "bank not found" }
Get child Banks for the given Bank in the hierarchy.
get /banks/{bankId}/children
Get child Banks for the given Bank in the hierarchy.
URI Parameters
- bankId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Bank:239@base.url",
"uri": "http://base.url/open/campusapi/assessment/bank/assessment.Bank%3A239%40base.url",
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"genusTypeId": "type.Type:defaultBankType@base.url",
"recordTypeIds": [ "type.Type:exampleBankRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add Bank as child of the given Bank in the hierarchy.
Remove the given Bank as a child of the given Bank in the hierarchy.
put /banks/{bankId}/children/{childId}
Add Bank as child of the given Bank in the hierarchy.
URI Parameters
- bankId: required(string)
- childId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The child Bank has been added to the hierarchy" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "bank not found" }
delete /banks/{bankId}/children/{childId}
Remove the given Bank as a child of the given Bank in the hierarchy.
URI Parameters
- bankId: required(string)
- childId: required(string)
Get parent Banks for the given Bank in the hierarchy.
get /banks/{bankId}/parents
Get parent Banks for the given Bank in the hierarchy.
URI Parameters
- bankId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Bank:239@base.url",
"uri": "http://base.url/open/campusapi/assessment/bank/assessment.Bank%3A239%40base.url",
"displayName": "Display Name of this Bank",
"description": "The description of this Bank",
"genusTypeId": "type.Type:defaultBankType@base.url",
"recordTypeIds": [ "type.Type:exampleBankRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Bank@base.url",
"license": "The license that applies to this Bank"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Get all Items in this Bank
get /banks/{bankId}/items
Get all Items in this Bank
URI Parameters
- bankId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "learningObjectives", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleItemType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleItemType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleItemType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Item:297@base.url",
"uri": "http://base.url/open/campusapi/assessment/item/assessment.Item%3A297%40base.url",
"displayName": "Display Name of this Item",
"description": "The description of this Item",
"genusTypeId": "type.Type:defaultItemType@base.url",
"recordTypeIds": [ "type.Type:exampleItemRecordType@campusapi.org", "..."],
"learningObjectiveIds": [ "learning.Objective:2572@base.url", "..." ],
"questionId": "assessment.Question:7288@base.url",
"answerIds": [ "assessment.Answer:8724@base.url", "..." ]
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given Item to this Bank
Remove the given Item from the Bank.
put /banks/{bankId}/items/{itemId}
Add the given Item to this Bank
URI Parameters
- bankId: required(string)
- itemId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "Item has been added to Bank" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "Item not found" }
delete /banks/{bankId}/items/{itemId}
Remove the given Item from the Bank.
URI Parameters
- bankId: required(string)
- itemId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "Item has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "Item not found" }
Get all Assessments in this Bank
get /banks/{bankId}/assessments
Get all Assessments in this Bank
URI Parameters
- bankId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.Assessment:3491@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment/assessment.Assessment%3A3491%40base.url",
"displayName": "Display Name of this Assessment",
"description": "The description of this Assessment",
"genusTypeId": "type.Type:defaultAssessmentType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentRecordType@campusapi.org", "..."],
"levelId": "grading.Grade:4367@base.url",
"rubricId": "assessment.Assessment:1580@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given Assessment to this Bank
Remove the given Assessment from the Bank.
put /banks/{bankId}/assessments/{assessmentId}
Add the given Assessment to this Bank
URI Parameters
- bankId: required(string)
- assessmentId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "Assessment has been added to Bank" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "Assessment not found" }
delete /banks/{bankId}/assessments/{assessmentId}
Remove the given Assessment from the Bank.
URI Parameters
- bankId: required(string)
- assessmentId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "Assessment has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "Assessment not found" }
Get all AssessmentsOffered in this Bank
get /banks/{bankId}/assessments-offered
Get all AssessmentsOffered in this Bank
URI Parameters
- bankId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "level", "scoreSystem", "gradeSystem", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentOfferedType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentOfferedType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentOfferedType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.AssessmentOffered:1388@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_offered/assessment.AssessmentOffered%3A1388%40base.url",
"displayName": "Display Name of this AssessmentOffered",
"description": "The description of this AssessmentOffered",
"genusTypeId": "type.Type:defaultAssessmentOfferedType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentOfferedRecordType@campusapi.org", "..."],
"assessmentId": "assessment.Assessment:8819@base.url",
"levelId": "grading.Grade:2180@base.url",
"itemsSequential": true,
"itemsShuffled": true,
"startTime": "2020-10-03T08:00:00.000Z",
"deadline": "2021-07-21T23:15:30.123Z",
"duration": "P3DT3H",
"scoreSystemId": "grading.GradeSystem:2781@base.url",
"gradeSystemId": "grading.GradeSystem:2729@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given AssessmentsOffered to this Bank
Remove the given AssessmentsOffered from the Bank.
put /banks/{bankId}/assessments-offered/{assessmentOfferedId}
Add the given AssessmentsOffered to this Bank
URI Parameters
- bankId: required(string)
- assessmentOfferedId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsOffered has been added to Bank" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsOffered not found" }
delete /banks/{bankId}/assessments-offered/{assessmentOfferedId}
Remove the given AssessmentsOffered from the Bank.
URI Parameters
- bankId: required(string)
- assessmentOfferedId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsOffered has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsOffered not found" }
Get all AssessmentsTaken in this Bank
get /banks/{bankId}/assessments-taken
Get all AssessmentsTaken in this Bank
URI Parameters
- bankId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "taker", "assessmentOffered", "takingAgent", "scoreSystem", "grade", "rubric", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentTakenType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentTakenType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentTakenType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "assessment.AssessmentTaken:9503@base.url",
"uri": "http://base.url/open/campusapi/assessment/assessment_taken/assessment.AssessmentTaken%3A9503%40base.url",
"displayName": "Display Name of this AssessmentTaken",
"description": "The description of this AssessmentTaken",
"genusTypeId": "type.Type:defaultAssessmentTakenType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentTakenRecordType@campusapi.org", "..."],
"takerId": "resource.Resource:9031@base.url",
"takingAgentId": "authentication.Agent:5255@base.url",
"actualStartTime": "2020-10-03T08:00:00.000Z",
"assessmentOfferedId": "assessment.AssessmentOffered:1709@base.url",
"completionTime": "2021-07-21T23:15:30.000Z",
"scoreSystemId": "grading.GradeSystem:642@base.url",
"score": 3.14,
"gradeId": "grading.Grade:6662@base.url",
"feedback": "This is the Feedback",
"rubricId": "assessment.AssessmentTaken:1200@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given AssessmentsTaken to this Bank
Remove the given AssessmentsTaken from the Bank.
put /banks/{bankId}/assessments-taken/{assessmentTakenId}
Add the given AssessmentsTaken to this Bank
URI Parameters
- bankId: required(string)
- assessmentTakenId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsTaken has been added to Bank" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsTaken not found" }
delete /banks/{bankId}/assessments-taken/{assessmentTakenId}
Remove the given AssessmentsTaken from the Bank.
URI Parameters
- bankId: required(string)
- assessmentTakenId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsTaken has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentsTaken not found" }