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

خلاصہ

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

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

بنياد URL

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

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

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

ہر ایک کے فیلڈ کے ساتھ تمام کیلکولیٹروں کی مشين پڑھنے والی فهرست واپس کر تا ہے (کی، لیبل، قسم، ڈیفالٹ، یونٹی) اور نتيجہ کی کلیدیں - ایک کلائنٹ کو متحرک طور پر بنانے کے لیے کافی. هر فائل ميں لازمي فلگ هے هے جو چند فائل کے ليے صحيح هے جن ميں دي فا ئل نهيں هے ( اکثر تا ريخوں کے ليے ) ان کو بھیج دیں : بعض کليکلر کيا ں ، بقيه جواب 400 هيں

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

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

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

پیرامیٹرز، ڈیفالٹ اور غلطیاں

صرف وہ فائل بھیجیں جنکے بارے ميں آپ کو دلچسپي هے جو آپ چھوڑ دیں وہ اس فائل کے شائع شدہ ديافتاد سے بھرا جاتا هے - وہي قيمت کيليکٹور صفحے پر قبلا لف ليں هے ، اس ليے API اور ويب سائٹ ہمیشہ ايک ئي نمبر واپس کريں هے ايک ئي ان ٹکسٹ کے ليے ہر جواب اسکے تحت جو ملے هيں اسکے ليے فهرست کريں defaults_applied.

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

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

´ظ´آ °إء /api/v1/ index ہر شعبے کی کلید، قسم، یونٹ، ڈیفالٹ اور اگر یہ ضروری ہے تو شائع کرتا ہے - ایک کلائنٹ بنانے کے لیے کافی ہے جو کبھی بھی اندازہ نہیں لگاتا.

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

آپ 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 کال / ماہ، ترجیح ترروپٹ.

آپ کے کوٹ کے خلاف کیا شمار

صرف ایک کامیاب جواب کرتا هے ۔ ایک 2xx = ایک کال ہر غلطي مفت هے : غلط هذان پرائمر کے ليے 400 ، غلط قيمت يا غائب لازمي شعبے کے ليے 404 ، نامعلوم سلگ کے ليے 404 ، غلط کي 401 ، 429 ، اور جو کچھ بھی غلطي سے گزرتا هے ہمارے جانب سے کنٹرکٹ کو تلاش کريں اور آپ کي درخواست کو اتنا بار درست کريں جتنا آپ کو ضرورت هے ۔ آپ کو جواب کے ليے بلنگ دیا جاتا هے ، اصلاح کے ليے نہیں ۔

غلطياں آزاد هے اور انکے بدلے ريا ں محدود هے اگر يک کليد سے زائد کي ريا ں 200 ایک گھنٹے میں ردعمل، یہ HTTP 429 "too_many_invalid_requests" حاصل کرتا ہے جب تک کہ گھنٹہ ختم نہ ہو۔ کامیاب کال اس کے لیے کبھی شمار نہیں ہوتے، اس لئے کام کرنے والا انٹیگریشن کبھی بھی اسے نہیں دیکھے گا۔ یہ صرف ایک کلاینٹ کو ایک دوبارہ کوشش لوپ میں پھنسنے سے پکڑتا ہے۔

جب ایک کلید کی ماہانہ کوٹہ استعمال ہو جائے تو 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);

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

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

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