CanvasClassUsages

Canvas Class Usage Domain Service

More information: https://it.byu.edu
Contact Info: api@byu.edu

Base URL: /domains/canvas/class_usages

Version: v1

Default request content-types: application/json
Default response content-types: application/json, text/csv
Schemes: https

Summary

Path Operation Description
/ GET

classes

/{year_term} GET

classes

Paths

classes

GET /

Returns the course usage data for all canvas courses.

Uses default content-types: application/json text/csv

200 OK

The course usage data for all canvas courses.

Example for application/json
{
"metadata": {
"validation_response": {
"code": 200,
"message": "Success"
}
}
,
"values": [
{
"canvas_published_flag": "Y",
"canvas_section_id": "none",
"catalog_number": "none",
"catalog_suffix": "",
"credit_hours": "3",
"fixed_or_variable": "F",
"minimum_credit_hours": "3",
"section_credit_hours": "369",
"section_number": "none",
"teaching_area": "none",
"total_enrolled": "123",
"year_term": "20175"
},
{
"canvas__section_id": "20175-CS-236-001",
"canvas_published_flag": "Y",
"catalog_number": "236",
"catalog_suffix": "",
"credit_hours": "3",
"fixed_or_variable": "F",
"minimum_credit_hours": "3",
"section_credit_hours": "369",
"section_number": "001",
"teaching_area": "C S",
"total_enrolled": "123",
"year_term": "20175"
}
]
}
400 Bad Request #/responses/400

Invalid Request - unable to interpret request

Example for application/json
{
"metadata": {
"validation_response": {
"code": 400,
"message": "Invalid Request - unable to interpret request"
}
}
}
401 Unauthorized #/responses/401

Authentication required to access data

Example for application/json
{
"metadata": {
"validation_response": {
"code": 401,
"message": "Authentication required to access data"
}
}
}
403 Forbidden #/responses/403

Access denied to protected data

Example for application/json
{
"metadata": {
"validation_response": {
"code": 403,
"message": "Access denied to protected data"
}
}
}
404 Not Found #/responses/404

The resource does not exist

Example for application/json
{
"metadata": {
"validation_response": {
"code": 404,
"message": "The resource does not exist"
}
}
}
409 Conflict #/responses/409

Query parameters conflict or are malformed

Example for application/json
{
"metadata": {
"validation_response": {
"code": 409,
"message": "Query parameters conflict or are malformed"
}
}
}
classes

GET /{year_term}

Returns the course usage data for all canvas courses for the specified year_term.

year_term

Year Term of Class

path string
csv

Boolean flag to return csv document

query boolean

Uses default content-types: application/json text/csv

200 OK

The course usage data for all canvas courses for the specified year_term.

Example for application/json
{
"metadata": {
"validation_response": {
"code": 200,
"message": "Success"
}
}
,
"values": [
{
"canvas_published_flag": "Y",
"canvas_section_id": "none",
"catalog_number": "none",
"catalog_suffix": "",
"credit_hours": "3",
"fixed_or_variable": "F",
"minimum_credit_hours": "3",
"section_credit_hours": "369",
"section_number": "none",
"teaching_area": "none",
"total_enrolled": "123",
"year_term": "20175"
},
{
"canvas__section_id": "20175-CS-236-001",
"canvas_published_flag": "Y",
"catalog_number": "236",
"catalog_suffix": "",
"credit_hours": "3",
"fixed_or_variable": "F",
"minimum_credit_hours": "3",
"section_credit_hours": "369",
"section_number": "001",
"teaching_area": "C S",
"total_enrolled": "123",
"year_term": "20175"
}
]
}
400 Bad Request #/responses/400

Invalid Request - unable to interpret request

Example for application/json
{
"metadata": {
"validation_response": {
"code": 400,
"message": "Invalid Request - unable to interpret request"
}
}
}
401 Unauthorized #/responses/401

Authentication required to access data

Example for application/json
{
"metadata": {
"validation_response": {
"code": 401,
"message": "Authentication required to access data"
}
}
}
403 Forbidden #/responses/403

Access denied to protected data

Example for application/json
{
"metadata": {
"validation_response": {
"code": 403,
"message": "Access denied to protected data"
}
}
}
404 Not Found #/responses/404

The resource does not exist

Example for application/json
{
"metadata": {
"validation_response": {
"code": 404,
"message": "The resource does not exist"
}
}
}
409 Conflict #/responses/409

Query parameters conflict or are malformed

Example for application/json
{
"metadata": {
"validation_response": {
"code": 409,
"message": "Query parameters conflict or are malformed"
}
}
}

Parameter definitions

year_term year_term

Year Term

path string

Response definitions

400

Invalid Request - unable to interpret request

Example for application/json
{
"metadata": {
"validation_response": {
"code": 400,
"message": "Invalid Request - unable to interpret request"
}
}
}
401

Authentication required to access data

Example for application/json
{
"metadata": {
"validation_response": {
"code": 401,
"message": "Authentication required to access data"
}
}
}
403

Access denied to protected data

Example for application/json
{
"metadata": {
"validation_response": {
"code": 403,
"message": "Access denied to protected data"
}
}
}
404

The resource does not exist

Example for application/json
{
"metadata": {
"validation_response": {
"code": 404,
"message": "The resource does not exist"
}
}
}
409

Query parameters conflict or are malformed

Example for application/json
{
"metadata": {
"validation_response": {
"code": 409,
"message": "Query parameters conflict or are malformed"
}
}
}

Schema definitions

class: object

year_term: string

The year_term being queried

canvas_section_id: string

The unique canvas indetifier with the format (year_term)-(teaching_area)-(catalog_number)(catalog_suffix)-(section_number) without spaces or &.

teaching_area: string

The course teaching area (dept_name)

catalog_number: string

The course catalog number.

catalog_suffix: string

The course catalog suffix.

section_number: string

The course section number

fixed_or_variable: string

Whether or not the credit hours are fixed or variable credit

credit_hours: number

If fixed credit, the credit hours of the course. If variable credit, the max credit hours of the course.

minimum_credit_hours: number

If fixed credit, the credit hours of the course. If variable credit, the minimum credit hours of the course.

total_enrolled: number

The number of enrolled students, including students with W grades.

section_credit_hours: number

enrolled_students * credit_hours

canvas_published_flag: string

Whether or not the course was published in Canvas

classes: object[]

StringResponse: string

Service Path: 
/domains/canvas/class_usages
Domain or University API: 
/domains/canvas/class_usages

Community

 

Don't see your question listed here? Ask!