Automated REST Access to KTU Announcements
Direct, decoupled API service scraping circulars and notifications from APJ Abdul Kalam Technological University via Camoufox. Attachments are pre-cached in memory for instant downloads.
api API Endpoints
GET
arrow_forward
GET
arrow_forward
GET
arrow_forward
GET
arrow_forward
GET
arrow_forward
GET
arrow_forward
GET
arrow_forward
GET
arrow_forward
POST
arrow_forward
GET
arrow_forward
/announcements
List all cached university announcements
/announcements?limit=5
Retrieve only the N most recent records
/announcements?new_only=true
Filter records flagged as new by KTU
/announcements?scheme=2019
Filter by scheme (e.g. 2015, 2019, 2024, or General)
/announcements/{id}
Fetch a single announcement by its numeric ID
/download/{encrypt_id}
Download an attached document directly as a PDF (pre-cached)
/health
Service status, Turnstile token state, and cache timestamps
/refresh?secret=...
Dispatch on-demand scraper run (requires secret, 10m cooldown)
/api/sync
Scraper data ingestion endpoint (requires X-Sync-Secret)
/docs
Interactive Swagger UI / OpenAPI documentation