🔌 गणनाकर्ता

पूर्वावलोकन

एपीआई वेबसाइट प्रयोग सटीक नै गणित चल्छ. क्वेरी मापदण्ड वा JSON रूपमा एक क्याल्कुलेटर को क्षेत्र मान पठाउन र JSON रूपमा फिर्ता गणना परिणाम प्राप्त - कुनै amortization तालिका वा चार्ट डाटा सहित क्याल्कुलेटर उत्पादन.

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

आधार यूआरएल

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

अनुक्रमणिका - प्रत्येक क्याल्कुलेटर सूचीबद्ध गर्नुहोस्

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

प्रत्येक एकको फिल्डहरू (कुञ्जी, लेबुल, प्रकार, पूर्वनिर्धारित, इकाई) र परिणाम कुञ्जीहरूसँग सबै क्याल्कुलेटरहरूको मेसिन-पढ्न योग्य सूची फर्काउँछ - गतिशील रूपमा क्लाइन्ट निर्माण गर्न पर्याप्त। प्रत्येक क्षेत्र पनि आवश्यक झण्डा बोक्छ — कुनै पूर्वनिर्धारित छ कि केही क्षेत्रहरू लागि साँचो (मिति, धेरै). ती पठाउनुहोस्: गणना एक जोडी यो बिना एक infer गर्न सक्छन्, बाँकी उत्तर 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. अज्ञात स्लगले ४०४ फर्काउँछ; असमर्थित देश वा खराब आगतले ४०० उपयोगी सन्देश र फिल्ड निर्दिष्टतासँग फर्काउँछ ।

परिमिति, पूर्वनिर्धारित र त्रुटि

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

एपीआई इमान्दारतापूर्वक समाधान गर्न सक्दैन केही एक त्रुटि छ, कहिल्यै शून्य: एक misspelled परिमिति, गलत प्रकार को एक मूल्य, एक अज्ञात ड्रपडाउन विकल्प, वा कुनै पूर्वनिर्धारित छ कि एक हराइरहेको फाँट (मिति फाँट - जन्म मिति अनुमान गर्न सकिँदैन). हरेक 400 नाम अपशब्द परिमिति र एक ग्राहक आफैलाई सुधार गर्न सक्छन् त्यसैले पूर्ण फिल्ड spec echoes.

$ 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/ सूचकांक हरेक क्षेत्र को कुञ्जी, प्रकार, इकाई, पूर्वनिर्धारित र यो आवश्यक छ कि छैन प्रकाशित - कहिल्यै guesses कि एक ग्राहक निर्माण गर्न पर्याप्त।

प्रमाणीकरण र योजना

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

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"

• स्वतन्त्र — बेनामी (आईपी दर-सीमित) वा एक सानो मासिक कोटा संग एक नि: शुल्क कुञ्जी। गैर-व्यावसायिक।
• विकासकर्ता — $9/महिना — १०,००० कल/महिना, व्यावसायिक प्रयोग।
• व्यापार — $49/महिना — १००,००० कल / महिना, प्राथमिकता थ्रुपुट।

तपाईँको कोटा विरुद्ध के गणना हुन्छ

केवल एक सफल प्रतिक्रिया गर्छ. एक 2xx = एक कल. हरेक त्रुटि मुक्त छ: एक 400 एक misspelled परिमिति लागि, एक खराब मान वा एक हराइरहेको आवश्यक फाँट, एक 404 एक अज्ञात slug लागि, एक 401 एक खराब कुञ्जी लागि, एक 429, र हाम्रो पक्ष मा गलत जान्छ केहि. सम्झौता खोजी र तपाईं आवश्यक रूपमा धेरै पटक आफ्नो अनुरोध समाधान - तपाईं जवाफ लागि बिल छन्, सुधार लागि होइन.

त्रुटिहरू निःशुल्क भएकाले तिनीहरू सट्टामा दर-सीमित छन्: यदि एक कुञ्जीले भन्दा बढी उत्तेजित गर्दछ भने 200 एक घण्टा मा अस्वीकार प्रतिक्रिया, यो HTTP 429 "too_many_invalid_requests" सम्म घण्टा रोलहरू सम्म प्राप्त. सफल कल कहिल्यै तिर गणना, त्यसैले एक काम एकीकरण कहिल्यै यो देख्नेछ - यो मात्र एक ग्राहक एक retry लूप मा अड्किएको पकड.

जब कुञ्जीको मासिक कोटा प्रयोग हुन्छ एपीआईले 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/ अनुक्रमणिका.