🔌 Gratis räknemaskin API

Översikt

API:et kör exakt samma matematik som webbplatsen använder. Skicka en kalkylators fältvärden som frågeparametrar eller JSON och få de beräknade resultaten tillbaka som JSON — inklusive eventuella amorteringsschema eller diagram data som kalkylatorn producerar.

• 198+ räknare, var och en med sitt eget effektmått
• Ingen API- nyckel — anonym åtkomst, taxebegränsad genom IP
• CORS — Access-Control-Allow-Origin: * (Användbar klientsida)
• Räntegräns: 60 Begäran/timme per IP (HTTP 429 om den överskrids)
• Fel är fria — Endast ett lyckat (2xx) svar använder ett samtal från din månatliga kvot. Var 400, 401, 404, 429 och 500 kostar dig ingenting.

Baswebbadress

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

Index – lista varje miniräknare

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

Returnerar en maskinläsbar lista över alla räknare med varje fält (nyckel, etikett, typ, standard, enhet) och resultatnycklar – tillräckligt för att bygga en klient dynamiskt. Varje fält har också en flagga som krävs – sant för de få fält som inte har någon standard (de flesta datum). Skicka dem: ett par miniräknare kan dra en, resten svar 400 utan det.

Beräkna – kör en miniräknare

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

Svarsform:

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

Landsmedvetna miniräknare (lån, lån, inkomst-skatt, försäljningsskatt...) accepterar ?country=us|uk|ca|au|in|ie|nz|za. Okänd snigel returnerar 404, land utan stöd eller dålig inmatning returnerar 400 med ett användbart meddelande och fältet spec.

Parametrar, förvalda värden och fel

Skicka bara de fält du bryr dig om. Allt du lämnar ut är fyllt med det fältets publicerade standard – samma värde som miniräknaren sidan förfyller, så API och webbplatsen returnerar alltid samma nummer för samma indata. Varje svar listar vad det fyllde i under defaults_applied.

Allt API:et inte kan lösa ärligt är ett fel, aldrig en nolla: en felstavad parameter, ett värde av fel typ, ett okänt dropdown alternativ, eller ett saknas fält som inte har någon standard (datumfälten – ett födelsedatum kan inte gissas). Varje 400 namn den kränkande parametern och ekar den fullständiga fält spec så att en klient kan korrigera sig själv.

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

och /api/v1/ index publicerar varje fälts nyckel, typ, enhet, standard och om det krävs – tillräckligt för att bygga en klient som aldrig gissar.

Behörighetskontroll & amp; - planer

Du kan ringa API:et utan nyckel alls – anonyma förfrågningar är hastighetsbegränsade av IP. För en högre, förutsägbar månadskvot (och kommersiell användning), skapa en nyckel på din kontosida och skicka det ett av tre sätt:

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"

• Fritt — anonym (IP-prisbegränsad) eller en gratis nyckel med en liten månadskvot.
• Utvecklare — $9/ mo — 10 000 samtal/månad, kommersiell användning.
• Affärs & mdash; $49/ mo — 100 000 samtal/månad, prioritetsgenomgång.

Vad som räknas mot din kvot

Bara ett lyckat svar gör det. En 2xx = ett samtal. Varje fel är gratis: en 400 för en felstavad parameter, ett dåligt värde eller ett felande obligatoriskt fält, en 404 för en okänd snigel, en 401 för en dålig nyckel, en 429, och allt som går fel på vår sida. Utforska kontraktet och rätta din begäran så många gånger som du behöver – du faktureras för svar, inte för korrigeringar.

Eftersom fel är gratis är de i stället hastighetsbegränsade: om en nyckel provocerar fram mer än 200 avvisade svar inom en timme, det får HTTP 429 "too_many_invalid_requests" tills timmen rullar över. Framgångsrika samtal räknas aldrig mot det, så en fungerande integration kommer aldrig att se det – det fångar bara en klient fast i en försök slinga.

När en nyckels månatliga kvot används tillbaka HTTP 429 med fel "quotation_exceed"; en okänd eller inaktiv nyckel returnerar HTTP 401. Se fullständiga planer och registrera dig på Prissättning för.

Exempel

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

Alla effektmått

Ett effektmått per kalkylator. Fälttangenter och resultattangenter för varje är i /api/v1/ Index.