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

ओवरव्यू

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

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

बेस यूआरएल

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

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

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

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 काल/ माह, प्राथमिकता शर्त के माध्यम से.

जब एक कुंजी का मासिक कोटा प्रयोग किया जाता है तो एपीआई का प्रयोग 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);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

सभी अंत- बिन्दु

प्रत्येक गणक पर एक अंत बिन्दु. फ़ील्ड कुंजी तथा परिणाम कुंजी /api/v1/ निर्देशिका.