Zakat Calculator API

Endpoint

• Route: POST /api/calculator
• Authentication: none (public access)
• Content-Type: application/json

Rate Limiting

• 5 requests per IP every 60 seconds.
• Exceeding the quota returns HTTP 429 with a Retry-After header.

Request Payload

• Send salary, expenses, and nisab amounts in MAD.
• All fields are required and must be numeric, non-negative values.

{
  "salary": 12000,
  "expenses": 6500,
  "nisab": 50000
}

Successful Response

• data.result contains monthly/annual savings, zakat amount (2.5%), and eligibility status.
• meta.rateLimit echoes the allowed quota, remaining calls, and current window.

{
  "ok": true,
  "data": {
    "currency": "MAD",
    "inputs": { "salary": 12000, "expenses": 6500, "nisab": 50000 },
    "result": {
      "monthlySaving": 5500,
      "annualSaving": 66000,
      "zakatAmount": 1650,
      "status": "eligible"
    }
  },
  "meta": {
    "rateLimit": { "limit": 5, "remaining": 4, "windowMs": 60000 }
  }
}

Error Codes

• 400 invalid_json — Body is not valid JSON.
• 400 invalid_input — Missing or non-numeric fields.
• 400 invalid_salary / invalid_expenses / invalid_nisab — Field-level validation failed.
• 405 method_not_allowed — Only POST is supported.
• 429 rate_limited — Too many requests within the window.
• 500 internal_error — Unexpected failure; check logs.