GET /api/codeforces/sync/:handle — manual sync

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/aakash811/Student-Progress-Tracker/llms.txt

Use this file to discover all available pages before exploring further.

​

Request

GET /api/codeforces/sync/:handle

​

Path parameters

​

How it works

1. Cache invalidation — All three Redis keys for the given handle are deleted in parallel before any data is fetched:
   • cf:info:<handle> — cached user info (rating, rank, maxRating)
   • cf:contest:<handle> — cached contest history
   • cf:submissions:<handle> — cached submission list
2. Parallel data fetch — After invalidation, three Codeforces API calls are made concurrently:
   • user.info — retrieves current rating, rank, and max rating
   • user.rating — retrieves the full contest rating history
   • user.status — retrieves up to 10,000 most recent submissions
3. lastActiveAt computation — The most recent submission with a verdict of OK is identified and its timestamp is used to set lastActiveAt on the student record.
4. MongoDB update — The student document is updated with currRating, rank, maxRating, contestData, submissions, lastActiveAt, and lastSyncedAt (set to the current server time). The query matches on codeforcesHandle.

​

Example request

curl https://your-api-host/api/codeforces/sync/tourist

​

Response

​

200 OK

{
  "message": "Codeforces data synced successfully",
  "student": {
    "_id": "64a1f2c3e4b0a1234567890a",
    "name": "Gennady Korotkevich",
    "email": "tourist@example.com",
    "codeforcesHandle": "tourist",
    "currRating": 3979,
    "rank": "Legendary Grandmaster",
    "maxRating": 3979,
    "lastSyncedAt": "2026-05-07T10:30:00.000Z",
    "lastActiveAt": "2026-05-06T18:45:22.000Z"
  }
}

​

Error responses

{
  "error": "No student found with the given Codeforces handle"
}

{
  "error": "Failed to sync Codeforces data"
}