CSE 341: Web Services

W02 Assignment: Part 4 - Reflect

Overview

In this final part of the Week 02 assignment, you will reflect on how your API changed, how you handled relationships, and how Swagger affected your testing process.

Do not use AI for this reflection

The purpose of this document is to help you reflect on your own work and describe the choices you made. This reflection should be written in your own words.

Preparation Material

Why reflection matters after implementation

Week 02 required more of your own decisions than Week 01. Reflection helps you notice whether your specification, issues, pull requests, Swagger documentation, and deployed API continued to match as the work became more complex.

Use evidence

Strong reflections refer to specific examples, such as a controller function, model function, Swagger route, GitHub issue, pull request, Render deployment, or MongoDB document.

Activity Instructions

Create a walk-through video

Your video should be less than 3 minutes and hosted in a location where graders can access it. Follow this script:

  1. Introduce yourself by saying your name.
  2. Show your deployed Swagger documentation at your Render /api-docs URL.
  3. Use deployed Swagger to demonstrate one book write route, such as creating, updating, or deleting a book.
  4. Use deployed Swagger to demonstrate one author route.
  5. In your code, show one controller that handles a successful response, a not-found case, and an unexpected error case.
  6. Explain one status code decision you made for a route. Why did you choose that status code?

Save the video somewhere the graders can access it, such as an unlisted YouTube video. After saving the video, try opening it in an incognito or private browser window to make sure someone else can access it. Include the video link in your reflection document where noted.

Create your reflection document

  1. Download the Week 02 reflection template.
  2. Open the template in VS Code.
  3. Answer each question in your own words.
  4. Save the completed document so you can upload it to Canvas.

Upload your reflection to Canvas

When your reflection is complete, upload the document directly to Canvas as part of your Week 02 assignment submission. You do not need to add this reflection document to your GitHub repository.

Next Step

This is the final part of the Week 02 assignment. Return to Canvas to submit your required links and upload this reflection document.

Assignment Grading

As mentioned in the syllabus, each element of this assignment must be complete to receive credit for the assignment. If any part is not complete yet, you will need to fix the issue and resubmit.

Other Links: