[PATCH] Accept A Student's Received Connection Request

[arafaysaleem]

Summary

As a student, I should be able to accept connection requests, so that I can add the student to my friends list.

Acceptance Criteria

GIVEN an student is accepting a friend request in the app
WHEN the app hits the /student-connections/:id endpoint with a valid PATCH request, containing the path parameter:

• id, the unique id of the entity being edited

AND the following body parameters:

• connection_status === 'friends'
• accepted_at datetime

THEN the app should receive a status 200
AND in the response, the following information should be returned:

• header message indicating update operation success
• rows matched
• rows changed

Sample Request/Sample Response

headers: {
    error: 0,
    message: "The specified item was updated successfully"
}
body: {
    rows_matched: 1,
    rows_changed: 1,
    info: "..."
}

Resources

• Development URL: {Here goes a URL to the feature on development API}
• Production URL: {Here goes a URL to the feature on production API}

Dev Notes

{Some complementary notes if necessary}

Testing Notes

Scenario 1: PATCH request is successful (Receiver)

1. Update a friend request with a PATCH request to /student-connections/:id endpoint with receiver_erp == erp in student account token.
2. A subsequent GET request to /student-connections/:id endpoint should return a status code 200
3. And the friend request details with the updated information i.e. matching the initially sent body.
4. Resubmit a PATCH request to /student-connections/:id endpoint to reverse the change and ensure status code 200 is returned.

Scenario 2: PATCH request is incorrect

1. Send a PATCH request to /student-connections/:id endpoint with an incorrect key name in the body
2. Ensure a 422 status code is returned
3. And the response headers' code parameter should contain "InvalidPropertiesException"
4. And the response headers' data parameter should contain the name of the invalid parameter

Scenario 3: PATCH request is forbidden

1. Send a PATCH request to /student-connections/:id endpoint with receiver_erp != erp in student account token.
2. Ensure the response returns a 403 forbidden status code.
3. And the response headers' code parameter should contain "ForbiddenException"

Scenario 4: PATCH request is unauthorized

1. Send a PATCH request to /student-connections/:id endpoint without an authorization token
2. Ensure a 401 unauthorized status code is returned.
3. And the response headers' code parameter should contain "TokenMissingException"