🔌 API Kalkulator Bebas

Lihat

API menjalankan matematik yang sama dengan laman web. Hantar nilai medan kalkulator sebagai parameter pertanyaan atau JSON dan dapatkan hasil yang dikira sebagai JSON — termasuk sebarang jadual amortisasi atau data carta yang kalkulator keluarkan.

• 198+ kalkulator, masing-masing dengan titik akhirnya sendiri
• Tiada kekunci API — akses anonim, kadar terhad oleh IP
• CORS — Access-Control-Allow-Origin: * (boleh digunakan klien-sisi)
• Had kadar: 60 permintaan/jam bagi IP (HTTP 429 bila melebihi)

URL Asas

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

Indeks — senaraikan setiap kalkulator

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

Kembalikan senarai boleh baca mesin bagi semua kalkulator dengan medan (kunci, label, jenis, default, unit) dan kunci hasil bagi setiap satu — cukup untuk bina klien secara dinamik.

Kira — 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 tindak balas:

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

Kalkulator negara-sedar (hipotek, pinjaman, cukai pendapatan, cukai jualan...) terima ?country=us|uk|ca|au|in|ie|nz|za. Slug tidak diketahui mengembalikan 404; negara tidak disokong atau input buruk mengembalikan 400 dengan mesej berguna dan spesifikasi medan.

Pengesahan

Anda boleh memanggil API tanpa kekunci sama sekali - permintaan anonim adalah terhad kadar oleh IP. Untuk kuota bulanan yang lebih tinggi, boleh diduga (dan penggunaan komersial), cipta kekunci pada halaman akaun anda dan hantar ia salah satu daripada 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 had kadar) atau kunci percuma dengan kuota bulanan kecil. Tidak komersial.
• Pemaju — $9/mo — 10,000 panggilan/bulan, penggunaan komersial.
• Perniagaan — $49/mo — 100,000 panggilan/bulan, laluan utama.

Apabila kuota bulanan kekunci digunakan, API mengembalikan HTTP 429 dengan ralat "quota_exceeded"; kekunci tidak diketahui atau tidak aktif mengembalikan HTTP 401. Lihat rancangan penuh dan daftar di Harga 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 akhir

Satu titik akhir bagi setiap kalkulator. Kekunci medan dan kekunci hasil bagi setiap satu adalah dalam /api/v1/ indeks.