feat: Retrieve User Testimonials API

[Laban254]

Description

Develop an API endpoint to retrieve all testimonials associated with a specific user.

Acceptance Criteria

• Only authenticated users can access this endpoint.
• The endpoint should be accessible at api/v1/testimonials/user/{user_id}.
• The endpoint should accept HTTP GET requests.
• Return appropriate response and status code.

Purpose

Delivers an API that retrieves all testimonials linked to a specific user.

Requirements

Data Validation:
The API should validate the request to ensure that the user_id is present and valid.

Expected Outcome

Successful retrieval of testimonials associated with the provided user_id.

Endpoint:

HTTP [GET] /api/v1/testimonials/user/{user_id}

API Request Example:

GET /api/v1/testimonials/user/{user_id}

{
  "Content-Type": "application/json",
  "Authorization": "Bearer <token>"
}

API Successful Response

{
  "status": "success",
  "status_code": 200,
  "message": "User testimonials retrieved successfully",
  "data": [
    {
      "id": "string",
      "user_id": "string",
      "content": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}

API Error Response

Bad Request

{
  "status": "error",
  "status_code": 400,
  "message": "Invalid request parameters",
  "error": "string"
}

Not Found

{
  "status": "error",
  "status_code": 404,
  "message": "User not found or no testimonials available",
  "error": "string"
}

Server Error

{
  "status": "error",
  "status_code": 500,
  "message": "Internal server error",
  "error": "string"
}

Tasks

• Develop server-side logic to handle retrieving testimonials for a specific user.
• Validate the incoming user_id parameter.
• Ensure proper error handling for edge cases such as non-existing users or users with no testimonials.

Testing

• Write unit tests for the testimonial retrieval logic.
• Test various scenarios, including:
  • Retrieving testimonials for an existing user.
  • Trying with an invalid user_id.

[Laban254]

slack ID: @kibe