...
- Allowing/requiring the API to return EVERY course summary is slow, taxing on the API server, and not scalable
- Causes >5s load time on Insights course listing page (that page users see right after logging in)
- Dave, paraphrased: "Sure, it works now... but what if we get 10,000 courses? Or 50,000? Allowing an endpoint to return that much data is not good"
...
http(s)://<insights_host>/courses/#?<query_string>
| Method | Description | Query Parameters | Statuses |
|---|
| GET | - Get course listing page with aggregate data
- Aggregate data is NOT affected by filters/pagination
- Course summary data NOT loaded yet
- However, query parameters are accepted and used for subsequent course summary AJAX call
- Changing the query string will not reload the page, but will trigger an AJAX call that will update the table
- Sorting/filtering/paging the table will trigger an AJAX call and update the query string
| - sortKey (optional): One of the following. Default: catalog_course_title
- catalog_course_title
- start_date
- end_date
- cumulative_count
- count
- count_change_7_days
- verified_enrollment
- passing_users
- order (optional): One of the following. Default: asc
- availability (optional): Comma-separated list of one or more of the following. Default: all availabilities
- Archived
- Current
- Upcoming
- Unknown
- program_ids (optional): Comma-separated list of course IDs to filter by. Default: all programs
- text_search (optional): (Sub)string to filter by for course titles and IDs. Default: do not filter by search string
- page (optional): Page number. Default: 1
| - 401 if not authenticated
- 200 otherwise
|
Insights: Course Summaries API
http(s)://<insights_host>/api/course_summaries/v1/course_summaries/?<query_string>
| Method | Description | Query Parameters | Return Values | Statuses |
|---|
| GET | Get paginated list of course summaries | |
CourseIndexView - CourseIndex View 'sortKey'
- sort_order (optional): See
|
CourseIndex view - Course Index View 'order'
- ... all other params from
|
CourseIndex view - Course Index View ...
- page_size (optional): Page size. Max: 100, Default: 100
| - results: array of page of result dicts with fields:
- count
- end_date
- created
- cumulative_count
- programs
- enrollment_modes
- availability
- verified_enrollment
- pacing_type
- passing_users
- count_change_7_days
- course_id
- catalog_course_title
- catalog_course: course ID without run
- start_date
- count: total number of results (all pages)
- next: link to next page
- previous: link to previous page
- last_updated: String containing date of time result summaries were updated
| - 401 if not authenticated
- 404 if no results
- 422 if bad parameter key
- 422 if bad parameter value
- 200 otherwise
|
Analytics Data API: Course Aggregate Data
http(s)://<data_api_host>/api/v0.1/course_aggregate_data/?<query_string>Analytics Data API: Course Summaries
| Method | Description | Query Parameters | Return Value | Access |
|---|
| GET | Get aggregate data about a set of courses | - course_ids (optional): Comma-separated list of course IDs to filter by. Default: All courses
| - current_enrollment
- total_enrollment
- enrollment_change_7_days
- verified_enrollment
| Same as Insights Course Summaries API |
| POST | Same as GET, but number of course IDs is not restricted by URL length | Same as above, but comma-separated lists are JSON arrays of strings | Same as above | Same as above |
Analytics Data API: Course Summaries
http(s)://<data_api_host>/api/v0.1/course_summaries/?<query_string>
| Method | Description | Query Parameters | Return Value | Access |
|---|
| GET | Get a paginated list of course summaries, with optional filtering and sorting | - course_ids (optional): Comma-separated list of course IDs to filter by. Default: All courses
- ... all params from Insights Course Summaries API ...
| Same as Insights Course Summaries API, |
sans but - last_updated is not included
- next/previous have API hostname in URL
| Same as Insights Course Summaries API |
| POST | Same as GET, but number of course IDs is not restricted by URL length | Same as above, but comma-separated lists are JSON arrays of strings | Same as above - QUESTION: what to do about next/previous URLs?
| Same as above |