Skip to content
ifeify edited this page Jan 10, 2019 · 3 revisions

Available tutors for a course

lists all available tutors for a course. We expect this to be a short list (estimating <10) so no need to limit the number of records returned. We, however, expect the result to be sorted either in ascending order by name or by top tutors in terms of ratings.

NOTE: All communication is done via SSL/TLS

HTTP request sample

GET /courses/{course_id}/tutors HTTP/1.1
User-Agent: TutorsToGo/v1/iOS/11.1
Host: www.somewhere.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

sortBy=rating

Success Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[{
    "tutor_id": "Xgsfdgsdskki81jdskkd",
    "tutor_name": "Fran",
    "rating": "5"
},
{
    "tutor_id": "Xgsfdgcdskki92jdskkf",
    "tutor_name": "Great",
    "rating": "5"
},
{
    "tutor_id": "usdygsfdgsdskki81jdsl",
    "tutor_name": "Kevin",
    "rating": "5"
}] 

No tutors available

HTTP/1.1 404 Not Found
Content-Type: application/json

[]