API Reference & Backend (apps/api)
NestJS API architecture at api.srazone.et with Swagger documentation
NestJS API Reference (apps/api)
The backend service powering SraHub is built on NestJS, TypeORM, and PostgreSQL (Neon DB), deployed at https://api.srazone.et/api.
Interactive API Documentation (Swagger)
Full interactive OpenAPI / Swagger documentation is served live at:
- Production Swagger UI: https://api.srazone.et/api/docs
- Local Dev Swagger UI:
http://localhost:3005/api/docs
Core Endpoint Groups
| Module | Base Path | Description |
|---|---|---|
| Auth | /api/auth | Login, Register, Google OAuth, Telegram Link, Cookie SSO |
| Jobs | /api/jobs | Job listings, category counts, salary insights, popular searches |
| Employer | /api/employer | Employer job creation, company management, applicant tracking |
| Alerts | /api/job-alerts | User alert subscriptions & Telegram notifications |
| Admin | /api/admin | Scraper scheduling, pipeline metrics, directory moderation |
Database Connection & Production Config
PORT=3005
DATABASE_URL=postgresql://user:password@host/neondb?sslmode=require
CORS_ORIGIN=https://srazone.et,https://employeer.srazone.et,https://admin.srazone.et