🔌 فری کالکولیٹر API

خلاصہ

API بالکل اسی ریاضی کو چلاتا ہے جو ویب سائٹ استعمال کرتی ہے. ایک کیلکولیٹر کے فیلڈ کے قدروں کو سوال پیرامیٹرز یا JSON کے طور پر بھیجیں اور JSON کے طور پر حساب شدہ نتائج واپس حاصل کریں - اس میں کوئی بھی خسارہ کی شیڈول یا چارٹ ڈیٹا شامل ہے جو کیلکولیٹر پیدا کرتا ہے.

• 198+ کلکٹر ، ہر کيا خودي آخري نقطہ
• کوئی API کلید نہیں — نامعلوم رسائی، IP کے ذریعے ریت-محدود
• CORS — Access-Control-Allow-Origin: * (کلائنٹ سایڈ استعمال کرنے والا)
• حد: 60 درخواستیں/ گھنٹہ ہر IP (HTTP 429 جب تجاوز)

بنياد URL

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

شاخص - ہر کیلکولیٹر کا فهرست

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

ہر ایک کے فیلڈ کے ساتھ تمام کیلکولیٹروں کی مشين پڑھنے والی فهرست واپس کر تا ہے (کی، لیبل، قسم، ڈیفالٹ، یونٹی) اور نتيجہ کی کلیدیں - ایک کلائنٹ کو متحرک طور پر بنانے کے لیے کافی.

حساب کريں - کليکل کير ں چلائيں

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

جوابي شکل:

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

ملک-خبر کالکولیٹر (مہر گيج، قرض، انکم ٹیکس، فروخت ٹیکس...) قبول کریں ?country=us|uk|ca|au|in|ie|nz|za. نامعلوم سلگ 404 واپس کرتا ہے؛ غیرمؤازہ ملک یا برے انٹاپٹ 400 واپس کرتا ہے ایک مددگار پیغام اور فیلڈ کی وضاحت کے ساتھ.

توثیق اور منصوبے

آپ API کو کوئی کلید کے بغیر بھی بلا سکتے ہیں - نامعلوم درخواستیں IP کے ذریعے ریت-محدود ہیں. ایک اعلی، پیش گوئی شدہ ماہانہ کوٹے (اور تجارتی استعمال) کے لیے، اپنے اکاؤنٹ کی صفحے پر ایک کلید بناؤ اور اسے تین طریقوں میں سے ایک سے بھیجیں:

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"

• مفت — نامعلوم (IP ریت-محدود) یا ایک مفت کلید ایک چھوٹے ماہانہ کوٹی کے ساتھ. غیر تجارتی.
• ڈیولپر $9/مئی — 10،000 کال / ماہ، تجارتی استعمال.
• کاروبار $49/مئی — 100،000 کال / ماہ، ترجیح ترروپٹ.

جب ایک کلید کی ماہانہ کوٹہ استعمال ہو جائے تو API HTTP 429 کو واپس کرتا ہے غلطی کے ساتھ "quota_exceeded"؛ ایک نامعلوم یا غیر فعال کلید HTTP 401 کو واپس کرتی ہے۔ مکمل منصوبے دیکھو اور پر دستخط قیمت صفحہ.

مثالیں

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

تمام انتہا پوائنٹ

هر کليکلر کے ليے يک آخري نقطہ هر کيو ڑي کے ليے فائل کيز اور نتيجہ کيز /api/v1/ شاخص.