Activity Tracking

​

Register Visited POI

​

Authentication

Authorization: Bearer <jwt_token>

​

Path Parameters

​

Query Parameters

​

Response

{
  "message": "POI registrado como visitado"
}

​

Code Examples

curl -X POST "https://api.tesisrutas.com/usuarios/507f1f77bcf86cd799439011/visitados?poi_id=507f191e810c19729de860ea" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​

Error Responses

{
  "detail": "No autorizado"
}

{
  "detail": "No se pudo registrar el POI visitado."
}

​

Register Completed Route

​

Authentication

Authorization: Bearer <jwt_token>

​

Path Parameters

​

Body Parameters

​

Request Example

{
  "ruta_id": "507f191e810c19729de860ec",
  "fecha": "2024-03-15T10:30:00Z",
  "duracion": 120,
  "calificacion": 5
}

​

Response

{
  "message": "Ruta registrada correctamente"
}

​

Code Examples

curl -X POST "https://api.tesisrutas.com/usuarios/507f1f77bcf86cd799439011/rutasRegister" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "ruta_id": "507f191e810c19729de860ec",
    "fecha": "2024-03-15T10:30:00Z",
    "duracion": 120,
    "calificacion": 5
  }'

​

Error Responses

{
  "detail": "No autorizado"
}

{
  "detail": "No se pudo registrar la ruta recorrida."
}

​

Authorization Rules

• Self-track: Users can track their own activity (visited POIs and completed routes)
• Admin-track: Admins can track activity for any user
• Restricted: Users cannot track activity for other users unless they are admins

​

Use Cases

• Personalized recommendations based on user history
• Gamification with achievements and progress tracking
• Analytics to understand popular POIs and routes
• User engagement metrics and retention analysis

​

Implementation Details

• Visited POIs: Uses $addToSet to prevent duplicate entries in the pois_visitados array
• Completed Routes: Uses $push to append route completion data to the rutas_recorridas array, allowing multiple completions of the same route