🔌 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é)
• Les erreurs sont libres — Une seule réponse réussie (2xx) utilise un appel de votre quota mensuel. Chaque 400, 401, 404, 429 et 500 ne vous coûte rien.

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. Chaque champ porte également un drapeau obligatoire — vrai pour les quelques champs qui n'ont pas de par défaut (dates, la plupart du temps). Envoyez-les : quelques calculatrices peuvent en déduire un, le reste répond 400 sans elle.

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":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

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.

Paramètres, défauts et erreurs

Envoyez seulement les champs qui vous intéressent. Tout ce que vous laissez de côté est rempli avec la valeur par défaut publiée de ce champ — la même valeur que la page calculatrice pré-remplit, de sorte que l'API et le site Web retournent toujours les mêmes numéros pour les mêmes entrées. Chaque réponse liste ce qu'elle a rempli sous defaults_applied.

Tout ce que l'API ne peut résoudre honnêtement est une erreur, jamais un zéro : un paramètre mal orthographié, une valeur du mauvais type, une option de dépôt inconnue ou un champ manquant qui n'a pas de défaut (les champs date – une date de naissance ne peut pas être devinée).

$ curl "https://calculator.free/api/v1/mortgage/?price=350000&rate=6.5&term=30"
{
  "ok": false,
  "error": "unknown_parameter",
  "message": "Unknown parameter 'term' for calculator 'mortgage'. Did you mean 'years'? ...",
  "unknown_parameters": ["term"],
  "did_you_mean": { "term": "years" },
  "valid_parameters": ["down", "extra", "extra_onetime", "extra_yearly", "hoa",
                       "insurance", "other", "pmi", "price", "rate", "tax", "years"],
  "fields": [ ... ]
}

Les /api/v1/ index publie la clé, le type, l'unité, la valeur par défaut de chaque champ et si elle est nécessaire — assez pour construire un client qui ne devine jamais.

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.

Ce qui compte par rapport à votre quota

Une seule réponse réussie. Une 2xx = un appel. Chaque erreur est libre : un 400 pour un paramètre mal orthographié, une mauvaise valeur ou un champ requis manquant, un 404 pour une limace inconnue, un 401 pour une mauvaise clé, un 429, et tout ce qui va mal de notre côté. Explorez le contrat et corrigez votre demande autant de fois que vous avez besoin — vous êtes facturé pour des réponses, pas pour des corrections.

Parce que les erreurs sont libres, elles sont limitées par le taux : si une clé provoque plus que 200 Les réponses rejetées en une heure, il obtient HTTP 429 "too_many_invalid_requests" jusqu'à ce que l'heure se termine. Les appels réussis ne comptent jamais pour cela, donc une intégration de travail ne le verra jamais — il ne saisit qu'un client coincé dans une boucle de réessayer.

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);

Python

import requests

r = requests.get("https://calculator.free/api/v1/mortgage/",
                 params={"price": 350000, "down": 70000,
                         "rate": 6.9, "years": 30},
                 headers={"Authorization": "Bearer YOUR_KEY"})
print(r.json()["results"])

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.