🔌 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)
• Galat Gratis — hanya sebuah respon (2xx) yang berhasil menggunakan satu panggilan dari kuota bulanan anda. setiap 400, 401, 404, 429 dan 500 tidak ada biaya.

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. Setiap bidang juga membawa tanda yang diperlukan ° benar untuk beberapa bidang yang tidak memiliki standar (tanggal, kebanyakan).

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":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

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.

Parameter, default dan errors

Kirim hanya bidang yang Anda pedulikan. Apapun yang Anda tinggalkan diisi dengan isi baku bidang itu, nilai yang sama dengan halaman kalkulator pra-isi, jadi API dan situs selalu mengembalikan nomor yang sama untuk masukan yang sama. Setiap daftar respon apa yang diisi di bawah. defaults_applied.

Apapun yang API tidak dapat selesaikan dengan jujur adalah kesalahan, tidak pernah nol: sebuah parameter salah eja, nilai dari tipe yang salah, sebuah pilihan dropdown yang tidak diketahui, atau sebuah daerah yang hilang yang tidak memiliki standar (bagian tanggal ▪ tanggal lahir tidak dapat diduga). Setiap 400 nama parameter yang menyinggung dan menggema spesifikasi seluruh daerah sehingga klien dapat memperbaiki dirinya sendiri.

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

The /api/v1/ indeks mempublikasikan setiap kunci, tipe, unit, baku dan apakah diperlukan cukup untuk membangun klien yang tidak pernah menebak.

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.

Apa yang dianggap tidak sesuai dengan kuota Anda

Hanya satu respon yang berhasil. 1 2xx = satu panggilan. setiap kesalahan adalah gratis: 400 untuk parameter yang salah eja, nilai yang buruk atau hilang lapangan yang dibutuhkan, sebuah 404 untuk peluru yang tidak diketahui, 401 untuk kunci yang buruk, 429, dan apa pun yang salah di sisi kita.eksplore kontrak dan memperbaiki permintaan Anda sebanyak yang Anda butuhkan ▪ Anda dibayar untuk jawaban, bukan untuk koreksi.

Karena kesalahan Gratis, mereka dibatasi dengan kecepatan: jika satu kunci memprovokasi lebih dari 200 Respon yang ditolak dalam satu jam, HTTP 429 mendapat HTTP "terlalu banyak_invalid_requests" sampai jam berakhir. Panggilan sukses tidak pernah dihitung ke arah itu, sehingga integrasi kerja tidak akan pernah melihatnya those hanya menangkap klien terjebak dalam loop coba ulang.

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);

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

Semua titik ujung

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