🔌 मोफत कॅल्क्युलेटर API

ओळख

API वेबसाईट वापरते त्याप्रमाणेच गणित चालवते. कॅल्क्युलेटरचे क्षेत्र मूल्ये क्वेरी परिमाणे किंवा JSON म्हणून पाठवा आणि JSON म्हणून गणिती परिणाम परत मिळवा - कोणत्याही ॲमोर्टाइजेशन वेळापत्रक किंवा चार्ट माहितीसह कॅल्क्युलेटर उत्पादने.

• 198+ कॅल्क्युलेटर, प्रत्येकी स्वतःचे अंतबिंदू
• API कि नाही — Anonymous प्रवेश, 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": [ ... ]
}

The /api/v1/ प्रत्येक क्षेत्राची किल्ली, प्रकार, एकक, डिफॉल्ट आणि आवश्यक आहे की नाही हे प्रकाशित करते - एक ग्राहक निर्माण करण्यासाठी पुरेसे जे कधीही अंदाज लावत नाही.

अधिप्रमाणन & योजना

तुम्ही कुठल्याही किल्लीशिवाय 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/महिना — १०,०००/- या प्रमाणे व्याज द्यावे.
• व्यवसाय $49/महिना — 100,000 calls/month, priority throughput.

तुमच्या कोटा विरुद्ध काय गणले जाते

फक्त यशस्वी प्रतिसादच करतो. एक 2xx = एक कॉल. प्रत्येक त्रुटी मोफत आहे: 400 चुकीच्या वर्णलेखन params साठी, चुकीची किंमत किंवा हवे असलेले क्षेत्र नाही, 404 अज्ञात slug साठी, 401 चुकीच्या कि साठी, 429, आणि आमच्या बाजूने जे काही चुकीचे जाते. कराराची चौकशी करा व आपल्या विनंतीची आवश्यकता असल्यास अनेकदा सुधारणा करा - तुम्हाला उत्तरांसाठी बिल केले जाते, सुधारणा करीता नाही.

त्रुटी मुक्त आहेत म्हणून ते दर-सीमित आहेत: जर एक कि एकपेक्षा जास्त प्रॉव्हिड करते 200 एका तासाच्या आत प्रतिसाद नाकारले, ते HTTP 429 "too_many_invalid_requests" मिळते तास उलटण्यापर्यंत. यशस्वी कॉल कधीही त्यासाठी गणले जात नाही, म्हणून कार्यरत एकत्रीकरण कधीही ते पाहत नाही - ते फक्त पुन्हा प्रयत्न लूपमध्ये अडकलेल्या क्लाऐंटला पकडते.

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