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

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.

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":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

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.

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.

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

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.