🔌 Kostenlose Rechner-API

Überblick

Die API führt genau die gleiche Mathematik aus, die die Website verwendet. Senden Sie die Feldwerte eines Rechners als Abfrageparameter oder JSON und erhalten Sie die berechneten Ergebnisse als JSON zurück – einschließlich der amortisations- oder Chartdaten, die der Rechner erzeugt.

• 198+ Rechner, jeder mit seinem eigenen Endpunkt
• Kein API-Schlüssel — anonymer Zugriff, tarifbegrenzt durch IP
• CORS — Access-Control-Allow-Origin: * (nutzbare Client-Seite)
• Höchstsatz: 60 Anfragen/Stunde pro IP (HTTP 429 bei Überschreitung)
• Fehler sind kostenlos — Nur eine erfolgreiche (2xx) Antwort nutzt einen Anruf aus Ihrer monatlichen Quote. Jede 400, 401, 404, 429 und 500 kostet nichts.

Grund-URL

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

Index — jeden Rechner auflisten

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

Gibt eine maschinenlesbare Liste aller Rechner mit den Feldern (Schlüssel, Etikett, Typ, Standard, Einheit) und Ergebnisschlüsseln zurück – genug, um einen Client dynamisch zu erstellen. Jedes Feld trägt auch eine erforderliche Flagge – true für die wenigen Felder, die keine Standardeinstellung haben (meist Daten). Senden Sie diese: ein paar Rechner können einen ableiten, der Rest antwortet 400 ohne sie.

Berechnen — einen Rechner ausführen

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

Antwortform:

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

Land-aware-Rechner (Mortgage, Darlehen, Einkommenssteuer, Umsatzsteuer...) akzeptieren ?country=us|uk|ca|au|in|ie|nz|za. Unbekannte Schnecke liefert 404; nicht unterstütztes Land oder schlechte Eingabe liefert 400 mit einer hilfreichen Nachricht und der Feldspezifikation.

Parameter, Voreinstellungen und Fehler

Senden Sie nur die Felder, die Sie interessieren. Alles, was Sie verlassen, ist mit dem veröffentlichten Feld standardmäßig gefüllt — der gleiche Wert der Rechnerseite vorfills, so dass die API und die Website immer die gleichen Zahlen für die gleichen Eingaben. Jede Antwort listet, was es ausgefüllt unter defaults_applied.

Alles, was die API nicht ehrlich lösen kann, ist ein Fehler, nie ein Nullpunkt: ein falsch geschriebener Parameter, ein Wert des falschen Typs, eine unbekannte Dropdown-Option oder ein fehlendes Feld, das keine Standardeinstellung hat (die Datumsfelder — ein Geburtsdatum kann nicht erraten werden).

$ 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": [ ... ]
}

Das /api/v1/ index veröffentlicht Schlüssel, Typ, Einheit, Standard und ob es erforderlich ist – genug, um einen Client zu bauen, der nie erraten wird.

Authentifizierungs- &-Pläne

Sie können die API ohne Schlüssel anrufen – anonyme Anfragen werden durch IP tarifbegrenzt. Für eine höhere, vorhersehbare monatliche Quote (und kommerzielle Nutzung) erstellen Sie einen Schlüssel auf Ihrer Kontoseite und senden Sie ihm eine von drei Möglichkeiten:

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"

• Frei — anonym (IP-Rate begrenzt) oder einen freien Schlüssel mit einer kleinen monatlichen Quote. Nicht-kommerzielle.
• Entwickler — $9/mo — 10.000 Anrufe/Monat, kommerzielle Nutzung.
• Unternehmen — $49/Mo — 100.000 Anrufe/Monat, Prioritätsdurchsatz.

Was zählt gegen Ihre Quote

Nur eine erfolgreiche Antwort. Ein 2xx = ein Anruf. Jeder Fehler ist kostenlos: ein 400 für einen falsch geschriebenen Parameter, ein schlechter Wert oder ein fehlendes erforderliches Feld, ein 404 für eine unbekannte Schnecke, ein 401 für einen schlechten Schlüssel, ein 429 und alles, was auf unserer Seite schief geht. Erforschen Sie den Vertrag und beheben Sie Ihre Anfrage so oft wie Sie brauchen – Sie werden für Antworten berechnet, nicht für Korrekturen.

Da Fehler frei sind, werden sie stattdessen tarifbegrenzt: Wenn ein Schlüssel mehr als 200 Die Antworten werden innerhalb einer Stunde abgelehnt, es wird HTTP 429 "zuviel_invalid_requests" bis die Stunde vorbei ist. Erfolgreiche Anrufe zählen nie dazu, so dass eine funktionierende Integration es nie sehen wird – es fängt nur einen Client, der in einer Wiederholungsschleife feststeckt.

Wenn die monatliche Quote eines Schlüssels verwendet wird, gibt die API HTTP 429 mit Fehler "quota_exceeded" zurück; ein unbekannter oder inaktiver Schlüssel gibt HTTP 401 zurück. Die Kommission hat die Preisgestaltung Seite.

Beispiele

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}'

Alle Endpunkte

Ein Endpunkt pro Rechner. Feldtasten und Ergebnistasten für jeden befinden sich in der /api/v1/ index.