🔌 Özgür hesap makinesi API

Genel Bakış

API, web sitesinin kullandığı matematikle aynı matematiki kullanır. Bir hesaplayıcının alan değerlerini sorgu parametreleri veya JSON olarak gönderin ve hesaplamanın ürettiği herhangi bir amortisman planı veya grafik verileri dahil olmak üzere hesaplanan sonuçları JSON olarak geri alın.

• 198+ hesap makineleri, her biri kendi son noktasına sahip
• API anahtarı yok — anonim erişim, IP ile hız sınırlı
• CORS — Access-Control-Allow-Origin: * (kullanılabilir istemci tarafı)
• Hız sınırı: 60 IP başına saat başına talepler (aşıldığında HTTP 429)

Temel URL

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

İndeks — her hesaplayıcıyı listele

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

Her birinin alanları (anahtar, etiket, tür, varsayılan, birim) ve sonuç anahtarları ile tüm hesaplayıcıların makine okunabilir bir listesini geri verir - dinamik olarak bir istemci inşa etmek için yeterli.

Hesaplama — bir hesap makinesi çalıştır

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

Cevap şekli:

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

Ülke bilincinde hesaplayıcılar (mortgage, loan, income-tax, sales-tax…) kabul edilir ?country=us|uk|ca|au|in|ie|nz|za. Bilinmeyen slug 404 geri döner; desteklenmeyen ülke veya kötü giriş, yardımcı bir mesaj ve alan spesifikasyonuyla 400 geri döner.

Kimlik doğrulama ve planlar

API'yi hiçbir anahtar olmadan çağırabilirsiniz — anonim istekler IP tarafından hız sınırlıdır. Daha yüksek, tahmin edilebilir aylık kota (ve ticari kullanım) için, hesabınız sayfasında bir anahtar oluşturun ve üç yoldan birini gönderin:

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"

• Özgür — anonim (IP hızı sınırlı) veya küçük aylık bir kotasyonla ücretsiz bir anahtar. Ticari olmayan.
• Geliştirici — $9/ay — Ayda 10.000 çağrı, ticari kullanım.
• İş — $49/ay — Ayda 100.000 çağrı, öncelikli işlem hacmi.

Bir anahtar aylık kotası kullanıldığında API HTTP 429 ile "quota_exceeded" hatasını geri döndürür; bilinmeyen veya etkin olmayan bir anahtar HTTP 401'i geri döndürür. Tüm planları görün ve kayıt olun Fiyatları sayfa.

Örnekler

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

Tüm son noktalar

Her hesap makinesi için bir son nokta. Her biri için alan anahtarları ve sonuç anahtarları aşağıdaki tablodadır. /api/v1/ indeks.