🔌 गणनाकर्ता

पूर्वावलोकन

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

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

आधार यूआरएल

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

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

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

प्रत्येक एकको फिल्डहरू (कुञ्जी, लेबुल, प्रकार, पूर्वनिर्धारित, इकाई) र परिणाम कुञ्जीहरूसँग सबै क्याल्कुलेटरहरूको मेसिन-पढ्न योग्य सूची फर्काउँछ - गतिशील रूपमा क्लाइन्ट निर्माण गर्न पर्याप्त।

गणना गर्नुहोस् — एउटा क्याल्कुलेटर चलाउनुहोस्

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. अज्ञात स्लगले ४०४ फर्काउँछ; असमर्थित देश वा खराब आगतले ४०० उपयोगी सन्देश र फिल्ड निर्दिष्टतासँग फर्काउँछ ।

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

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

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/महिना — १००,००० कल / महिना, प्राथमिकता थ्रुपुट।

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

POST JSON

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

सबै अन्त्य बिन्दुहरू

प्रति गणक एक अन्त बिन्दु। प्रत्येक लागि फिल्ड कुञ्जीहरू र परिणाम कुञ्जीहरू मा छन् /api/v1/ अनुक्रमणिका.