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

ओवरव्यू

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

• 198+ गणकों, प्रत्येक अपने अंत बिन्दु सहित
• कोई एपीआई कुंजी नहीं — अज्ञात पहुँच, IP द्वारा निर्धारित दर- दर- निर्दिष्ट
• CORS — Access-Control-Allow-Origin: * (प्रयोग में असमर्थ क्लाइंट)
• रेट सीमा: 60 प्रति आईपी (HTTP249) से अधिक घंटे के लिए निवेदन करता है
• त्रुटियाँ मुक्त हैं — केवल एक सफल (2xx) प्रतिक्रिया एक कॉल का उपयोग आपके मासिक कोटा से करता है. हर 400, 401, 4049 और 500 खर्च आप कुछ भी नहीं.

बेस यूआरएल

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

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

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

एक मशीन के सभी मौजूदा गणकों की सूची बताता है (key, लेबल, प्रकार, डिफ़ॉल्ट) और परिणाम कुंजियाँ — एक सक्रिय ग्राहक बनाने के लिए पर्याप्त है. हर क्षेत्र में एक माँगी ध्वज भी होता है — उन थोड़े क्षेत्रों के लिए जो कोई डिफ़ॉल्ट रूप से, नहीं होते हैं ।

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

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. अज्ञात Suug का परिणाम होगा 404; असमर्थित देश या खराब इनपुट का परिणाम होगा सहायक संदेश और क्षेत्र स्पेस से.

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

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

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

केवल एक सफल प्रतिक्रिया है. एक 2x = एक कॉल के लिए। प्रत्येक त्रुटि मुक्त है: एक गलत पैरामीटर, एक अज्ञात मूल्य या एक अज्ञात क्षेत्र के लिए 404, एक गलत कुंजी के लिए, एक 404 के लिए, एक 404 के लिए, एक गलत कुंजी, और कुछ भी जो हमारे पक्ष में चला जाता है. सौदा और आप के रूप में कई बार की जरूरत है के रूप में आप के लिए अनुरोध कर रहे हैं, कोई सुधार नहीं कर रहे हैं, आप के लिए नहीं कर रहे हैं.

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

जब एक कुंजी का मासिक कोटा प्रयोग किया जाता है तो एपीआई का प्रयोग HTTP49 के साथ होता है "quota_exd; एक अज्ञात या निष्क्रिय कुंजी HTTP1 लौटाता है. पूरी योजना देखें और पर हस्ताक्षर करें प्राक्की पृष्ठ.

उदाहरण

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/ निर्देशिका.