🔌 API de calculatrice gratuite

Aperçu général

L'API exécute exactement le même calcul que le site Web utilise. Envoyez les valeurs de champ d'une calculatrice comme paramètres de requête ou JSON et récupérez les résultats calculés comme JSON — y compris tout calendrier d'amortissement ou données de graphique que la calculatrice produit.

• 198+ calculatrices, chacune avec son propre point d'arrêt
• Pas de clé API — accès anonyme, limité par IP
• CORS — Access-Control-Allow-Origin: * (côté client utilisable)
• Taux limite: 60 demandes/heure par IP (HTTP 429 lorsque dépassé)

URL de base

https://calculator.free/api/v1/

Index — lister chaque calculatrice

GET https://calculator.free/api/v1/

Retourne une liste lisible par machine de toutes les calculatrices avec les champs de chacune (clé, étiquette, type, défaut, unité) et les clés de résultat – assez pour construire un client dynamiquement.

Calculer — exécuter une calculatrice

GET  https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/     (JSON or form body)

Forme de réponse:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Calculatrices de pays (mortgage, prêt, impôt sur le revenu, taxe de vente...) accepter ?country=us|uk|ca|au|in|ie|nz|za. L'inconnu retourne 404; le pays non pris en charge ou les mauvais entrées retourne 400 avec un message utile et les spécifications de champ.

Authentification des plans &

Vous pouvez appeler l'API sans aucune clé — les requêtes anonymes sont limitées par IP. Pour un quota mensuel plus élevé et prévisible (et une utilisation commerciale), créez une clé sur votre page de compte et envoyez-la de trois façons:

GET  https://calculator.free/api/v1/mortgage/?price=350000&key=YOUR_KEY
curl -H "Authorization: Bearer YOUR_KEY" "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"
curl -H "X-Api-Key: YOUR_KEY"           "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"

• Gratuit — anonyme (IP taux limité) ou une clé libre avec un petit quota mensuel. Non-commercial.
• Développeur — $9/mo — 10 000 appels par mois, utilisation commerciale.
• Affaires — 49 $/mois — 100 000 appels par mois, débit prioritaire.

Quand le quota mensuel d'une clé est utilisé, l'API retourne HTTP 429 avec une erreur "quota_exceeded" ; une clé inconnue ou inactive renvoie HTTP 401. Voir les plans complets et s'inscrire sur le Prix page.

Exemples

curl

curl "https://calculator.free/api/v1/mortgage/?price=350000&down=70000&rate=6.9&years=30"

JavaScript fetch()

const r = await fetch(
  "https://calculator.free/api/v1/bmi/?" + new URLSearchParams({
    units: "metric", height: "180", weight: "80"
  }));
const { results } = await r.json();
console.log(results.bmi, results.category);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

Tous les paramètres

Un point d'arrivée par calculatrice. Les touches de champ et les touches de résultat pour chaque sont dans le /api/v1/ indice.