API Calculatrice de Zakat

Endpoint

• Route : POST /api/calculator
• Authentification : aucune (public)
• Content-Type : application/json

Limitation de débit

• 5 requêtes par minute et par adresse IP (60 secondes).
• Une réponse 429 inclut l’en-tête Retry-After indiquant le temps d’attente.

Corps de requête

• Envoyez le salaire, les dépenses et le nisab en MAD.
• Les trois champs sont obligatoires et doivent être numériques.

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

Réponse réussie

• data.result indique l’épargne mensuelle/annuelle, le montant de la zakat et le statut.
• meta.rateLimit retourne le plafond et le quota restant.

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

Codes d’erreur

• 400 invalid_json — JSON invalide.
• 400 invalid_input — Champs manquants ou non numériques.
• 400 invalid_salary / invalid_expenses / invalid_nisab — Vérifiez les contraintes.
• 405 method_not_allowed — Seul POST est accepté.
• 429 rate_limited — Quota dépassé, réessayez plus tard.
• 500 internal_error — Problème interne, contrôler les logs.