CanvasClassUsages
Canvas Class Usage Domain Service
Base URL: /domains/canvas/class_usages
Version: v1
Summary
| Path | Operation | Description |
|---|---|---|
| / | GET | classes |
| /{year_term} | GET | classes |
Paths
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"
}
}
}
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
- 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
