🔌 API Kalkulator Bebas

Ringkasan

API menjalankan matematika yang sama persis dengan yang digunakan situs web. Kirim nilai ruas kalkulator sebagai parameter query atau JSON dan dapatkan hasil yang dihitung kembali sebagai JSON å termasuk jadwal amortisasi atau bagan data yang dihasilkan kalkulator.

• 198+ kalkulator, masing-masing dengan titik akhirnya sendiri
• Tak ada kunci API — akses anonim, rate-limited oleh IP
• CORS — Access-Control-Allow-Origin: * (sisi klien yang dapat digunakan)
• Batas laju: 60 permintaan/jam per IP (HTTP 429 ketika dilampaui)

URL Dasar

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

Indeks ▪ daftar setiap kalkulator

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

Mengembalikan daftar kalkulator yang dapat dibaca mesin dengan setiap jenis kunci, label, tipe, baku, unit) dan kunci hasil yang cukup untuk membangun klien secara dinamis.

Compute °O jalankan satu kalkulator

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

Bentuk respon:

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

Kalkulator kesadaran-negara (mortgage, pinjaman, pendapatan-tax, penjualan-tax...) terima ?country=us|uk|ca|au|in|ie|nz|za. Siput tak dikenal kembali 404; negara yang tidak didukung atau masukan buruk kembali 400 dengan pesan berguna dan spesifikasi lapangan.

Otentikasi & rencana

Anda dapat memanggil API tanpa kunci sama sekali permintaan enomia anonim yang dibatasi oleh IP. Untuk kuota bulanan yang lebih tinggi dan dapat diprediksi (dan penggunaan komersial), buat kunci pada halaman akun Anda dan kirimkan satu dari tiga cara:

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"

• Bebas — anonim (IP rate-limit) atau kunci bebas dengan kuota bulanan kecil. bukan komersil.
• Pengembang — 9/mo — 10.000 panggilan/bulan, penggunaan komersial.
• Bisnis — 49/mo — 100.000 panggilan/bulan, throughput prioritas.

Ketika sebuah kuota bulanan kunci digunakan sampai API mengembalikan HTTP 429 dengan galat "quota_exceed"; kunci yang tidak diketahui atau tidak aktif mengembalikan HTTP 401. Lihat rencana penuh dan mendaftar di Menilai halaman.

Contoh

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

Semua titik ujung

Satu titik akhir per kalkulator. Kunci ruas dan kunci hasil bagi masing-masing berada di /api/v1/ indeks.