🔌 නිදහස් කැල්ක්යුලේටර් API

දර්ශකය

API වෙබ් අඩවිය භාවිතා කරන හරියටම එම ගණිතය ධාවනය. විමසුම් පරාමිතීන් හෝ JSON ලෙස කැල්කියුලේටරය ක්ෂේත්ර අගයන් යැවීමට හා JSON ලෙස ආපසු ගණනය ප්රතිඵල ලබා ගන්න - කැල්කියුලේටරය නිපදවන ඕනෑම ආපසු ගෙවීමේ කාලසටහන හෝ චරිතාපදානය දත්ත ඇතුළු.

• 198+ ගණක, එහි අවසන් ස්ථානය එක් එක්
• API යතුරක් නැත — නිශ්චිත ප්රවේශය, IP විසින් අනුපාතය සීමා
• CORS — Access-Control-Allow-Origin: * (භාවිත කළ හැකි සේවාදායක- පැත්තේ)
• අනුපාත සීමා: 60 IP එකකට ඉල්ලීම් / පැය (HTTP 429 ඉක්මවා විට)

මූලික URL

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. නොදන්නා slug 404 ආපසු; සහාය නොමැති රට හෝ නරක ආදාන උපකාරී පණිවිඩය සහ ක්ෂේත්රය විශේෂාංග සමග 400 ආපසු.

සහතික කිරීම සහ සැලසුම්

ඔබ කිසිදු යතුරක් සමඟ 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/මස — 10,000 ඇමතුම් / මාස, වාණිජමය භාවිතය.
• ව්යාපාර — $49/මස — 100,000 ඇමතුම් / මාසයක්, ප්‍රමුඛතාවය ගලා.

යතුරක මාසික කොන්දේසිය භාවිතා කරන විට API 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/ සූචිය.