Overview
These endpoints allow professors to provide written feedback on student activities and retrieve previously submitted feedback.
Save Feedback
Activity identifier (e.g., “foro1”, “examen1”)
Feedback comment text from professor
curl -X POST "https://proyecto-ingenieria-software-6ccv.onrender.com/guardar_feedback" \
-H "Content-Type: application/json" \
-d '{
"email_alumno": "[email protected]",
"actividad": "foro1",
"comentario": "Excellent analysis of the limit concept. Consider exploring more complex examples."
}'
Request Model
The endpoint uses the FeedbackData model (lines 81-84):
class FeedbackData(BaseModel):
email_alumno: str
actividad: str
comentario: str
Request Example
{
"email_alumno": "[email protected]",
"actividad": "foro1",
"comentario": "Excellent analysis of the limit concept. Consider exploring more complex examples."
}
Response
Status message indicating success or error details
Indicates whether the operation succeeded (true) or failed (false)
Success Response
{
"mensaje": "Feedback enviado",
"exito": true
}
Error Response
{
"mensaje": "Error description",
"exito": false
}
Get Feedback
curl -X GET "https://proyecto-ingenieria-software-6ccv.onrender.com/obtener_feedback/[email protected]" \
-H "Content-Type: application/json"
Response Structure
Returns a dictionary mapping activity identifiers to their most recent feedback comments. The endpoint queries all feedback for the student, ordered by date descending, and returns only the latest comment for each activity.
Most recent feedback comment for the activity. Key is the activity identifier (e.g., “foro1”, “examen2”).
Response Example
{
"foro1": "Excellent analysis of the limit concept. Consider exploring more complex examples.",
"foro2": "Good work on derivatives. Review the chain rule application.",
"examen1": "Strong performance. Minor error in question 3.",
"foro3": "Great insight on integration techniques."
}
If a student has multiple feedback entries for the same activity, only the most recent comment is returned (determined by ORDER BY fecha DESC on line 735).
Implementation Details
Database Query (Save)
The save endpoint executes (lines 719-720):
INSERT INTO feedback (email_alumno, actividad, comentario)
VALUES (%s, %s, %s)
Database Query (Retrieve)
The retrieve endpoint executes (line 735):
SELECT * FROM feedback
WHERE email_alumno = %s
ORDER BY fecha DESC
feedback_dict = {}
for item in lista:
feedback_dict[item['actividad']] = item['comentario']
Usage Workflow
Saving Feedback (Frontend Example)
async function enviarFeedback(emailEstudiante, actividad, comentario) {
const response = await fetch('/guardar_feedback', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
email_alumno: emailEstudiante,
actividad: actividad,
comentario: comentario
})
});
const result = await response.json();
if (result.exito) {
console.log('Feedback saved successfully');
} else {
console.error('Error:', result.mensaje);
}
}
Retrieving Feedback (Frontend Example)
async function cargarFeedback(emailEstudiante) {
const response = await fetch(`/obtener_feedback/${emailEstudiante}`);
const feedbackDict = await response.json();
// Access feedback by activity
const foro1Feedback = feedbackDict['foro1'];
const examen1Feedback = feedbackDict['examen1'];
return feedbackDict;
}
Error Responses
Database connection error