🔌 API & Developer Docs

calculatorfc.online exposes a calculator API. Endpoints below are specified for the production backend (NestJS). The static build ships the full spec; deploy the backend to enable live calls.

REST

GET  /api/v1/calculators            → list all calculators
GET  /api/v1/calculators/:id        → calculator schema + formula
POST /api/v1/calculators/:id/run    → { inputs } → { results }
GET  /api/v1/categories             → list categories
POST /api/v1/auth/login             → JWT
GET  /api/v1/me/history             → saved calculations (auth)

GraphQL

query { calculator(id:"emi"){ name formula fields { key type } } }
mutation { runCalculator(id:"emi", inputs:{principal:2000000, rate:8.5, months:240}) { results } }

Webhooks

Subscribe to calculation.created, user.signup and review.posted events. Configure endpoints & secrets in Admin → API.

Auth & rate limits

Bearer JWT or API key. Free 1k/day, Pro 10k/day, Enterprise custom. RBAC scopes: read:calc, run:calc, admin:*.