🔌 API calcolatrice gratuita

Introduzione

L'API esegue la stessa matematica che utilizza il sito web. Inviare i valori di campo di una calcolatrice come parametri di query o JSON e ottenere i risultati calcolati indietro come JSON...

• 198+ calcolatrici, ognuna con il proprio endpoint
• Nessuna chiave API — accesso anonimo, limitato dalla tariffa IP
• CORS — Access-Control-Allow-Origin: * (lato cliente utilizzabile)
• Limite di frequenza: 60 richieste/ora per IP (HTTP 429 quando superato)
• Gli errori sono gratuiti — solo una risposta di successo (2xx) utilizza una chiamata dalla vostra quota mensile. Ogni 400, 401, 404, 429 e 500 costa nulla.

URL di base

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

Indice

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

Restituisce un elenco leggibile da macchina di tutte le calcolatrici con i campi di ciascuno (chiave, etichetta, tipo, impostazione predefinita, unità) e i tasti di risultato sugli elementi sufficientemente da creare un client in modo dinamico. Ogni campo porta anche un flag richiesto

Calcolare

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

Forma di risposta:

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

Calcolatrici country-aware (morticolo, prestito, imposta sul reddito, imposta sulle vendite...) accettare ?country=us|uk|ca|au|in|ie|nz|za. Lumaca sconosciuta restituisce 404; paese non supportato o input errato restituisce 400 con un messaggio utile e la specifica del campo.

Parametri, default ed errori

Invia solo i campi che ti interessano. Qualsiasi cosa si lascia fuori è riempito con quel campo pubblicato di default.., lo stesso valore la pagina calcolatrice pre-riempie, in modo che l'API e il sito web sempre restituire gli stessi numeri per gli stessi ingressi. Ogni risposta elenca ciò che ha compilato in sotto defaults_applied.

Qualsiasi cosa l'API non possa risolvere onestamente è un errore, mai uno zero: un parametro sbagliato, un valore del tipo sbagliato, un'opzione a discesa sconosciuta o un campo mancante che non ha valore predefinito (i campi data... non si può indovinare una data di nascita). Ogni 400 nomi il parametro di offesa ed echeggia la specifica del campo completo in modo che un client possa correggersi.

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

La /api/v1/ indice pubblica la chiave di ogni campo, tipo, unità, default e se è necessario abbastanza

Autenticazione e piani

È possibile chiamare l'API senza chiave per tutte le richieste anonime. • sono limitate tasso per IP. Per una quota mensile più alta e prevedibile (e uso commerciale), creare una chiave sulla pagina del tuo account e inviarlo uno dei tre modi:

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"

• Libero — anonimo (il tasso IP limitato) o una chiave gratuita con una piccola quota mensile. Non commerciale.
• Sviluppatore — $9/mo — 10.000 chiamate al mese, uso commerciale.
• Affari — $49/mo — 100.000 chiamate al mese, flusso prioritario.

Cosa conta contro la tua quota

Una 2xx = una chiamata. Ogni errore è gratuito: un 400 per un parametro sbagliato, un valore negativo o un campo richiesto mancante, un 404 per una pallottola sconosciuta, un 401 per una chiave cattiva, un 429, e tutto ciò che va storto dalla nostra parte. Esplora il contratto e ripara la tua richiesta quante volte hai bisogno di και ti viene addebitato per le risposte, non per le correzioni.

Perché gli errori sono liberi sono invece limitati: se una chiave provoca più di 200 risposte respinte in un'ora, ottiene HTTP 429 "troppo_molti_invalid_requests" fino a quando l'ora si alza. Chiamate di successo non contano mai verso questo, quindi un'integrazione di lavoro non lo vedrà mai

Quando la quota mensile di una chiave viene utilizzata l'API restituisce HTTP 429 con errore "quota_exceed"; una chiave sconosciuta o inattiva restituisce HTTP 401. Vedere i piani completi e firmare sul Prezzi pagina.

Esempi

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

Tutti gli endpoint

Un endpoint per calcolatrice. Le chiavi di campo e le chiavi di risultato per ciascuno sono nel /api/v1/ indice.