🔌 फ्री गणक एपीआई

ओवरव्यू

एपीआई ठीक उसी गणित वेबसाइट का उपयोग करता है. एक गणक का क्षेत्र मान खोजकर JSON के रूप में वापस प्राप्त करता है - जिसमें किसी भी इवेल्यूशन या चार्ट डाटा उत्पन्न करता है.

• 198+ गणकों, प्रत्येक अपने अंत बिन्दु सहित
• कोई एपीआई कुंजी नहीं — अज्ञात पहुँच, IP द्वारा निर्धारित दर- दर- निर्दिष्ट
• CORS — Access-Control-Allow-Origin: * (प्रयोग में असमर्थ क्लाइंट)
• रेट सीमा: 60 requests/hour per IP (HTTP 429 when exceeded)
• त्रुटियाँ मुक्त हैं — only a successful (2xx) response uses one call from your monthly quota. Every 400, 401, 404, 429 and 500 costs you nothing.

बेस यूआरएल

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

निर्देशिका — प्रत्येक गणक सूची

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

एक मशीन के सभी मौजूदा गणकों की सूची बताता है (key, लेबल, प्रकार, डिफ़ॉल्ट) और परिणाम कुंजियाँ — एक सक्रिय ग्राहक बनाने के लिए पर्याप्त है. Each field also carries a required flag — true for the few fields that have no default (dates, mostly). Send those: a couple of calculators can infer one, the rest answer 400 without it.

गणना करें — एक गणक चला रहा है

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. Unknown slug returns 404; unsupported country or bad input returns 400 with a helpful message and the field spec.

पैरामीटर, तयशुदा और त्रुटियाँ

केवल क्षेत्र भेजें जिसे आप बाहर छोड़ते हैं. जो कुछ भी छोड़ देते हैं वह उस क्षेत्र के पहले प्रकाशित से भरे हुए हैं - वही मूल्य है जो कि गणक से पहले भरा हुआ है, तो एपीआई तथा वेबसाइट हमेशा एक ही इनपुट के लिए फिर मिलेंगे. प्रत्येक प्रतिक्रिया की सूची दें जो आप बाहर भरी हुई है. defaults_applied.

ना ही एपीआई ईमानदारी से हल नहीं कर सकता, ना ही कोई शून्य पैरामीटर है: गलत किस्म का मूल्य, एक अज्ञात ड्रॉप विकल्प या एक लापता क्षेत्र जिसके पास कोई डिफ़ॉल्ट तारीख (काल क्षेत्र) नहीं है, अनुमान लगाया जा सकता है. प्रत्येक 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/ सूची हर फ़ील्ड की कुंजी, क़िस्म, इकाई, और क्या यह जरूरी है — एक ग्राहक बनाने के लिए पर्याप्त है जो कभी अनुमान नहीं लगा.

सत्यापन वर्मिंग; योजना

आप न किसी कुंजी के साथ एपीआई को कॉल कर सकते हैं - अज्ञात निवेदन आईपी द्वारा निर्धारित किया जाता है. उच्च, अनुमान योग्य मासिक कोटा (या उपयोग) के लिए, अपने खाता पृष्ठ पर कुंजी तैयार कर और उसे तीन तरीकों से भेज सकते हैं:

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"

• मुक्त — अज्ञातनाम (आईआरटीसी दर- एथ- वितरण) या एक छोटे मासिक कोटा के साथ मुफ्त कुंजी. गैर-crasc.
• डेवलपर तथामश; $9/मो — 10,000 कॉल / महीने, व्यावसायिक उपयोग.
• व्यापार वमश; $49/मो — 1,00,000 काल/ माह, प्राथमिकता शर्त के माध्यम से.

आपके कोटा के विरुद्ध कौन - सी बात मायने रखती है

Only a successful response does. One 2xx = one call. Every error is free: a 400 for a misspelled parameter, a bad value or a missing required field, a 404 for an unknown slug, a 401 for a bad key, a 429, and anything that goes wrong on our side. Explore the contract and fix your request as many times as you need — you are billed for answers, not for corrections.

क्योंकि त्रुटियों को छोड़ वे दर- निर्धारण के हैं; यदि एक कुंजी अधिक क्रोध करती है 200 एक घंटे में जवाब अस्वीकार कर दिया, यह होता है HTTP 429 "बहुत से अधिक_BAR_अवैध_stase" जब तक घंटे पाँसे खत्म नहीं होता. सफल कॉल कभी भी उस पर भरोसा नहीं करता, इसलिए एक कार्यात्मक संयोजन इसे कभी नहीं देखेंगे — यह केवल एक पुनः प्राप्त करने के लिए ले लेता है.

When a key's monthly quota is used up the API returns HTTP 429 with error "quota_exceeded"; an unknown or inactive key returns 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/ निर्देशिका.