Endpoints review - E7-I/conectados GitHub Wiki

POST /api/reviews/createReview

Descripción

Crea una nueva reseña para un servicio, asociada a una cita y a un profesional.

Parámetros de entrada

Nombre	Tipo	Descripción	Opcional
serviceId	string	ID del servicio al que se asocia la reseña	No
appointmentId	string	ID de la cita asociada	No
professionalId	string	ID del profesional que prestó el servicio	No
reviewerId	string	ID del usuario que realiza la reseña	No
stars	int	Estrellas de la reseña (entre 1 y 5)	No
comment	string	Comentario de la reseña	No

Respuesta

Código: 201 Created
Tipo: application/json

{
  "_id": "1",
  "serviceId": "123",
  "appointmentId": "456",
  "professionalId": "789",
  "reviewerId": "111",
  "stars": 5,
  "comment": "Excelente servicio"
}

Errores comunes

• 400 Bad Request: Campos requeridos faltantes o valores inválidos.
• 404 Not Found: El profesional o el revisor no fueron encontrados.
• 500 Internal Server Error: Error del servidor al crear la reseña.

GET /api/reviews/getReview/:id

Descripción

Obtiene una reseña por su ID.

Parámetros de entrada

Nombre	Tipo	Descripción	Opcional
id	string	ID de la reseña a obtener	No

Respuesta

Código: 200 OK
Tipo: application/json

{
  "_id": "1",
  "serviceId": "123",
  "appointmentId": "456",
  "professionalId": "789",
  "reviewerId": "111",
  "stars": 5,
  "comment": "Excelente servicio"
}

Errores comunes

• 404 Not Found: Reseña no encontrada.
• 500 Internal Server Error: Error del servidor al obtener la reseña.

PUT /api/reviews/updateReview/:id

Descripción

Actualiza una reseña existente por su ID.

Parámetros de entrada

Nombre	Tipo	Descripción	Opcional
id	string	ID de la reseña a actualizar	No
stars	int	Estrellas de la reseña (entre 1 y 5)	Sí
comment	string	Nuevo comentario de la reseña	Sí

Respuesta

Código: 200 OK
Tipo: application/json

{
  "_id": "1",
  "serviceId": "123",
  "appointmentId": "456",
  "professionalId": "789",
  "reviewerId": "111",
  "stars": 4,
  "comment": "Servicio mejorado, muy bueno."
}

Errores comunes

• 400 Bad Request: Valores inválidos para estrellas o comentario.
• 404 Not Found: Reseña no encontrada.
• 500 Internal Server Error: Error del servidor al actualizar la reseña.

DELETE /api/reviews/deleteReview/:id

Descripción

Elimina una reseña por su ID.

Parámetros de entrada

Nombre	Tipo	Descripción	Opcional
id	string	ID de la reseña a eliminar	No

Respuesta

Código: 200 OK
Tipo: application/json

{
  "message": "Review deleted successfully"
}

Errores comunes

• 404 Not Found: Reseña no encontrada.
• 500 Internal Server Error: Error del servidor al eliminar la reseña.

GET /api/reviews/getReviewsByProfessionalId/:professionalId

Descripción

Obtiene todas las reseñas asociadas a un profesional.

Parámetros de entrada

Nombre	Tipo	Descripción	Opcional
professionalId	string	ID del profesional cuyas reseñas se obtendrán	No

Respuesta

Código: 200 OK
Tipo: application/json

[
  {
    "_id": "1",
    "serviceId": "123",
    "appointmentId": "456",
    "professionalId": "789",
    "reviewerId": "111",
    "stars": 5,
    "comment": "Excelente servicio"
  }
]

Errores comunes

• 404 Not Found: No se encontraron reseñas para este profesional.
• 500 Internal Server Error: Error del servidor al obtener las reseñas.

GET /api/reviews/getReviewsByServiceId/:serviceId

Descripción

Obtiene todas las reseñas asociadas a un servicio.

Parámetros de entrada

Nombre	Tipo	Descripción	Opcional
serviceId	string	ID del servicio cuyas reseñas se obtendrán	No

Respuesta

Código: 200 OK
Tipo: application/json

[
  {
    "_id": "1",
    "serviceId": "123",
    "appointmentId": "456",
    "professionalId": "789",
    "reviewerId": "111",
    "stars": 5,
    "comment": "Excelente servicio"
  }
]

Errores comunes

• 400 Bad Request: Formato de serviceId inválido.
• 404 Not Found: No se encontraron reseñas para este servicio.
• 500 Internal Server Error: Error del servidor al obtener las reseñas.