Overview
This is the first version of API. The main purpose of this version of API is to provide a way for external applications, e.g., learning management system, to interact with iPeer with tighter integration and better user experience. Data returned will be in JSON format with XML support coming later.
Authentication
OAuth 1.0a
Resources
Users
| GET | /v1/users | get a list of users
|
| | parameter | none
|
| | input | none
|
| | status (success) | HTTP/1.0 200 OK
|
| | output (success) | [{"id":"USER0_ID","role_id":"ROLE_ID","username":"USERNAME0","last_name":"LAST_NAME","first_name":"FIRST_NAME"},{"id":"USER1_ID","role_id":"ROLE_ID","username":"USERNAME1","last_name":"LAST_NAME","first_name":"FIRST_NAME"}]
|
| | status (failure) | HTTP/1.0 404 Not Found
|
| | output (failure) | null
|
| GET | /v1/users/{id} | get a user with id
|
| | parameter | USER_ID
|
| | input | none
|
| | status (success) | HTTP/1.0 200 OK
|
| | output (success) | [{"id":"USER0_ID","role_id":"ROLE_ID","username":"USERNAME0","last_name":"LAST_NAME","first_name":"FIRST_NAME"}]
|
| | status (failure) | HTTP/1.0 404 Not Found
|
| | output (failure) | null
|
| POST | /v1/users | create a user
|
| | parameter | none
|
| | input | [{"role_id":"ROLE_ID","username":"USERNAME","last_name":"LAST_NAME","first_name":"FIRST_NAME"}]
|
| | status (success) | HTTP/1.0 201 CREATED
|
| | output (success) | [{"id":"USER_ID","role_id":"ROLE_ID","username":"USERNAME","last_name":"LAST_NAME","first_name":"FIRST_NAME"}]
|
| | status (failure) | HTTP/1.0 500 Internal Server Error
|
| | output (failure) | null
|
| POST | /v1/users | create users
|
| | parameter | none
|
| | input | [{"role_id":"ROLE_ID","username":"USERNAME0","last_name":"LAST_NAME","first_name":"FIRST_NAME"},{"role_id":"ROLE_ID","username":"USERNAME1","last_name":"LAST_NAME","first_name":"FIRST_NAME"}]
|
| | status (success) | HTTP/1.0 201 CREATED
|
| | output (success) | [{"id":"USER0_ID","role_id":"ROLE_ID","username":"USERNAME0","last_name":"LAST_NAME","first_name":"FIRST_NAME"},{"id":"USER1_ID","role_id":"ROLE_ID","username":"USERNAME1","last_name":"LAST_NAME","first_name":"FIRST_NAME"}]
|
| | status (failure) | HTTP/1.0 500 Internal Server Error
|
| | output (failure) | null
|
| DELETE | /v1/users/{id} | remove a user with id
|
| | parameter | USER_ID
|
| | input | none
|
| | status (success) | HTTP/1.0 204 No Content
|
| | output (success) | null
|
| | status (failure) | HTTP/1.0 500 Internal Server Error
|
| | output (failure) | null
|
| PUT | /v1/users/{id} | update a user with id
|
| | parameter | COURSE_ID
|
| | input | [{"id":"USER_ID","username":"USERNAME","last_name":"LAST_NAME","first_name":"FIRST_NAME","role_id":"ROLE_ID"}]
|
| | status (success) | HTTP/1.0 200 OK
|
| | output (success) | [{"id":"USER_ID","username":"USERNAME","last_name":"LAST_NAME","first_name":"FIRST_NAME","role_id":"ROLE_ID"}]
|
| | status (failure) | HTTP/1.0 500 Internal Server Error
|
| | output (failure) | null
|
Courses
| GET | /v1/courses | get a list of courses for current logged in user
|
| | parameter | none
|
| | input | none
|
| | status (success) | HTTP/1.0 200 OK
|
| | output (success) | [{"id":"COURSE0_ID","course":"COURSE0_CODE","title":"COURSE0_TITLE"},{"id":"COURSE1_ID","course":"COURSE1_CODE","title":"COURSE1_TITLE"}]
|
| | status (failure) | HTTP/1.0 404 Not Found
|
| | output (failure) | No courses can be found
|
| GET | /v1/courses/{id} | get a course with id
|
| | parameter | COURSE_ID
|
| | input | none
|
| | status (success) | HTTP/1.0 200 OK
|
| | output (success) | {"id":"COURSE_ID","course":"COURSE_CODE","title":"COURSE_TITLE"}
|
| | status (failure) | HTTP/1.0 404 Not Found
|
| | status (failure) | No course with id COURSE_ID can be found
|
| POST | /v1/courses | create a course
|
| | parameter | none
|
| | input | {"Course":{"course":"COURSE_CODE","title":"COURSE_TITLE"},"Department":{"Department":[DEPARTMENT_ID]}}
|
| | status (success) | HTTP/1.0 201 Created
|
| | output (success) | COURSE_ID
|
| | status (failure) | HTTP/1.0 500 Internal Server Error
|
| | output (failure) | Error: the course was not added
|
| DELETE | /v1/courses/{id} | remove a course with id
|
| | parameter | COURSE_ID
|
| | input | none
|
| | status (success) | HTTP/1.0 204 No Content
|
| | output (success) | COURSE_ID
|
| | status (failure) | HTTP/1.0 500 Internal Server Error
|
| | output (failure) | Error: the course was not deleted
|
| PUT | /v1/courses/{id} | update a course with id
|
| | parameter | none
|
| | input | {"Course":{"id":"COURSE_ID","course":"COURSE_CODE","title":"COURSE_TITLE"}}
|
| | status (success) | HTTP/1.0 200 OK
|
| | output (success) | COURSE_ID
|
| | status (failure) | HTTP/1.0 500 Internal Server Error
|
| | output (failure) | Error: the course was not edited
|
Courses/Users
| GET | /v1/courses/{course_id}/users | get a list of users associated within the course {course_id}
|
| POST | /v1/courses{course_id}/users/{user_id} | associate a user to the course by {course_id}
|
| POST | /v1/courses{course_id}/users | associate users to the course by {course_id}
|
| DELETE | /v1/courses/{course_id}/users/{user_id} | remove a user from the course
|
| DELETE | /v1/courses/{course_id}/users | remove users from the course
|
| | parameter | COURSE_ID
|
| | input | none for removing all users or [{"id":1},{"id":2},{"id":3}] for specific users (other fields are ignored)
|
| | status (success) | HTTP/1.0 204 No Content
|
| | output (success) | COURSE_ID
|
| | status (failure) | HTTP/1.0 500 users were not deleted
|
| | output (failure) | none
|
Groups
| GET | /v1/courses/{course_id}/groups | get a list of groups in course {course_id}
|
| GET | /v1/courses/{course_id}/groups/id | get a group in course by group id, course_id will be ignored
|
| POST | /v1/courses{course_id}/groups | create a group in course {course_id}
|
| DELETE | /v1/courses/{course_id}/groups/{id} | remove a group in course by group id, course_id will be ignored
|
| PUT | /v1/courses/{course_id}/groups/{id} | update a group in course by group id, course_id will be ignored
|
Groups/Users
| GET | /v1/groups/{group_id}/users | get a list of users associated within the group {group_id}
|
| GET | /v1/groups/{group_id}/users/{user_id} | get a user in group by {group_id}
|
| POST | /v1/groups{group_id}/users/{user_id} | associate users to the group by {group_id}
|
| POST | /v1/groups{group_id}/users | associate users to the group by {group_id}
|
| DELETE | /v1/groups/{group_id}/users/{user_id} | remove a user from the group
|
| DELETE | /v1/groups/{group_id}/users | remove users from the group
|
Grades
| GET | /v1/courses/{course_id}/grades | get a list of grades in course {course_id}
|
| GET | /v1/courses/{course_id}/grades/id | get a grades in course {course_id}
|
| GET | /v1/users/{user_id}/grades | get grades for a user
|
Events
| GET | /v1/courses/{course_id}/events | get a list of events in course {course_id}
|
| GET | /v1/courses/{course_id}/events/{event_id} | get a event in course {course_id}
|
| GET | /v1/users/{user_id}/events | get events for a user
|
