🔌 KalkulatèName

Aperçu

Envoye valè jaden yon calculateur kòm paramèt kesyon oswa JSON ak jwenn rezilta yo konpile tounen kòm JSON — ki gen ladan nenpòt pwogram amortisation oswa grafik done ke calculateur pwodwi.

• 198+ Kalkulatè, chak ak pwent bout li
• Pa gen kle API — anonim
• CORS — Access-Control-Allow-Origin: * (Itilizabl sou bò kliyan)
• Limit pou vitès: 60 demann/èdtan pou IP (HTTP 429 lè depase)

URL baz

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

Index — lis chak calculateur

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

Retounen yon lis machin-li-ka-li-nan tout calculateurs ak chak yon nan jaden yo (key, label, type, default, unit) ak rezilta kle yo - ase pou bati yon kliyan dinamikman.

Kalkile — kouri yon calculateur

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

Forme repons:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Kalkulatè ki gen rapò ak peyi (ipotèk, prè, taks sou revni, taks sou lavant…) aksepte ?country=us|uk|ca|au|in|ie|nz|za. Unknown slug returns 404; non-supported country or bad input returns 400 with a helpful message and the field spec.

Authentication & plans

Ou ka rele API a san yon kle — demann anonim yo limite pa IP. Pou yon komisyon menyèl ki pi wo ak ki ka prevwa (ak pou itilize komèsyal), kreye yon kle sou paj kont ou epi voye li nan youn nan twa fason sa yo:

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"

• Gratis — Ou ka itilize yon modpas anonim (IP rate-limited) oswa yon modpas gratis ak yon ti kantite lajan chak mwa.
• Developer — $9/mo — 10,000 apèl/mwa, pou itilize komèsyal.
• Biznis — $49/mo — 100,000 apèl / mwa, priyorite pwodiksyon.

Lè yon kle a mwayèn de yon mwa se itilize moute API a retounen HTTP 429 ak erè "quota_exceeded"; yon kle ki pa konnen oswa inactif retounen HTTP 401. Gade plan konplè ak enskri sou sit entènèt la Pri paj.

Egzamen

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

Tout pwent bout

Yon pwent fen pou chak calculateur. Fòma a kle ak rezilta kle pou chak se nan /api/v1/ Index.