API калькулятора закята

Endpoint

• Маршрут: POST /api/calculator
• Аутентификация: не требуется (публичный доступ)
• Content-Type: application/json

Лимит запросов

• 5 запросов на IP за 60 секунд.
• При превышении лимита вернётся 429 и заголовок Retry-After со временем ожидания.

Тело запроса

• Передавайте salary, expenses и nisab в MAD.
• Все поля обязательны и должны быть числами без знака «минус».

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

Успешный ответ

• В data.result находятся ежемесячные/годовые накопления, сумма закята и статус.
• meta.rateLimit сообщает общий лимит, остаток и длительность окна.

{
  "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 }
  }
}

Коды ошибок

• 400 invalid_json — Некорректный JSON.
• 400 invalid_input — Поля отсутствуют или заданы неверно.
• 400 invalid_salary / invalid_expenses / invalid_nisab — Нарушены правила валидации.
• 405 method_not_allowed — Поддерживается только POST.
• 429 rate_limited — Превышен лимит запросов.
• 500 internal_error — Неожиданная ошибка, проверьте логи.