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

දර්ශකය

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

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

පරාමිති, පෙරනිමි සහ දෝෂ

ඔබ ගැන සලකා ක්ෂේත්ර පමණක් යවන්න. ඔබ හැර ඕනෑම දෙයක් එම ක්ෂේත්රයේ ප්රකාශයට පත් පෙරනිමි පිරී ඇත - එම අගය කැල්ක්යුලේටර් පිටුව පෙර පිරවීම, ඒ නිසා API සහ වෙබ් අඩවිය හැම විටම එම ආදාන සඳහා එම අංක ආපසු. එක් එක් ප්රතිචාරය එය යටතේ පිරවූ දේ ලැයිස්තුගත defaults_applied.

API අවංකව විසඳිය නොහැකි ඕනෑම දෙයක් දෝෂයක්, ශුන්‍ය කවදාවත්: අකුරු වැරදි පරාමිතියක්, වැරදි වර්ගය අගය, නොදන්නා dropdown විකල්පය, හෝ කිසිදු පෙරනිමියක් ඇති නැති ක්ෂේත්රය (දින ක්ෂේත්ර - උපන් දිනය අනුමාන කළ නොහැකි). සෑම 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": [ ... ]
}

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

ඔබේ කොන්දේසි වලට එරෙහිව ගණනය කරන දේ

එක් 2xx = එක් ඇමතුමක්. සෑම දෝෂයක් නිදහස්: අකුරු වැරදි පරාමිතියක් සඳහා 400, නරක අගය හෝ අතුරුදහන් අවශ්ය ක්ෂේත්රය, නොදන්නා ස්ලග් සඳහා 404, නරක යතුර සඳහා 401, 429, හා අපගේ පැත්තෙන් වැරදි යනවා ඕනෑම දෙයක්. ඔබ අවශ්ය තරම් වරක් ගිවිසුම ගවේෂණය සහ ඔබේ ඉල්ලීම සකස් - ඔබ පිළිතුරු සඳහා බිල්පත්, නිවැරදි කිරීම් සඳහා නොවේ.

දෝෂ නිදහස් නිසා ඔවුන් වෙනුවට අනුපාතය සීමා වේ: එක් යතුරක් වඩා වැඩි ප්රචණ්ඩත්වයක් නම් 200 පැය කිහිපයකින් ප්රතිචාර ප්රතික්ෂේප කිරීම, පැය

යතුරක මාසික කොන්දේසිය භාවිතා කරන විට 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);

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/ සූචිය.