🔌 ഫ്രീ ഗണനി API

അവലോകനം

API ഉപയോഗമുള്ള അതേ കണക്കു് പ്രവര്‍ത്തിക്കുന്നു. ചോദ്യ- ദിശയായി ഒരു ഗണിതമുളള ഫീള്‍ഡ് മൂല്ല്യങ്ങള്‍ അയക്കുക അല്ലെങ്കില്‍ Jonson എന്ന പേരില്‍ Gcon ആയി കണക്കുകൂട്ടല്‍ നല്‍കുക.

• 198+ ഗണിതം, ഓരോന്നുള്ള അവസാന ബിന്ദു
• API കീയില്ല — അജ്ഞാതമായ പ്രവേശനം, ഐപി ഉപയോഗിച്ചു് നിരക്ക് മാറ്റി
• CORS — Access-Control-Allow-Origin: * (usable client-side)
• പരിധി: 60 ഒരു ഐപി/ മണിക്കൂര്‍ ആവശ്യങ്ങള്‍ (എച്ച്ടിപി 429 ആവര്‍ത്തനത്തിനു് ശേഷം)
• പിശകുകള്‍ സ്വതന്ത്രമാണ് — only a successful (2xx) response uses one call from your monthly quota. Every 400, 401, 404, 429 and 500 costs you nothing.

അടിസ്ഥാന യുആര്‍എല്‍

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

ഇന്‍ഡെക്സ് — ഓരോ കൌണ്ടിയിലും പട്ടിക

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

എല്ലാ കണക്ഷന്‍മാരുടെയും (key, ലേബല്‍, തരം, തരം, സഹജമായ, ഫല കീകള്‍) കൊണ്ടാണ് യന്ത്ര- വായിക്കാവുന്ന പട്ടിക തിരിച്ചുവിടുന്നു. ഒരു ക്ലയന്റിനെ സജീവമായി നിര്‍മ്മിക്കാൻ മാത്രം. Each field also carries a required flag — true for the few fields that have no default (dates, mostly). Send those: a couple of calculators can infer one, the rest answer 400 without it.

കണക്കുകൂട്ടുക —⁠ ഒരു ഗണിതം പ്രവര്‍ത്തിപ്പിക്കുക

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. അപരിചിതമായ vCard 404 നല്‍കുന്നു; പിന്തുണയില്ലാത്ത രാജ്യം അല്ലെങ്കില്‍ തെറ്റായ ഇന്‍പുട്ട് 400 നല്‍കുന്നു ഒരു സഹായ സന്ദേശം നല്‍കുന്നു ഫീള്‍ഡ് ഫോള്‍ട്ടും.

പരാമീറ്ററുകള്‍, സഹജമായതും പിശകുകളുമായവ

നിങ്ങള്‍ക്കായി വേണ്ട നിലങ്ങള്‍ മാത്രം നല്‍കുക. നിങ്ങള്‍ എത്ര വേണമെങ്കിലും ആ വയലില്‍ പ്രസദ്ധമാക്കാന്‍ കഴിഞ്ഞിട്ടുള്ള സഹജമായ രീതിയില്‍ മതി. അപ്രകാരമുള്ള കോംപൌണ്ട് പേജ്, അഡ്വെന്‍സ്, വെബ്സൈറ്റില്‍ ഒരേ സംഖ്യകള്‍ നല്‍കുക. ഓരോ മറുപടിയും, അത് താഴെ നിറയ്ക്കുന്നതിനെയും പട്ടികപ്പെടുത്തുന്നു. defaults_applied.

API-നു് സത്യസന്ധമായി തീരുമാനിക്കുവാന്‍ സാധ്യമല്ലാത്തതെന്തും ഒരു പിശക്, ഒരു ഡീല്‍, ഒരു 0 എന്നല്ല: തെറ്റായ തരം തരം, തെറ്റായ മൂല്യം, തെറ്റായ പ്ളഗിന്‍ അല്ലെങ്കില്‍ കീഴ്ചുറ്റല്‍ ഉപാധി, സ്വതവേയുള്ള സ്ഥലം (ഒരു തീയതി) ലഭ്യമല്ലാത്ത ഒരു നില. ഓരോ 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/ ഒരു ക്ലയന്റ് നിര്‍മ്മിക്കാന്‍ വേണ്ടി ഓരോ ഫീള്‍ഡിന്റെ കീ, തരം, യൂണിറ്റ്, സഹജമായി, അതാവശ്യമുണ്ടെങ്കില്‍ ഇന്‍ഡെക്സ് പ്രസിദ്ധീകരിക്കുന്നു.

ആധികാരികത ഉറപ്പാക്കല്‍ & p; പദ്ധതികള്‍

നിങ്ങള്‍ക്ക് API എന്ന വിളിക്കാം — അറിയപ്പെടാത്ത അപേക്ഷകള്‍ ഐപി- റേറ്റ് റേറ്റ് ആണ്. കൂടുതല്‍, അപൂര്‍വ്വമായ മാസവിവരക്കണക്ക് (ഇതും വാണിജ്യ ഉപയോഗം), നിങ്ങളുടെ അക്കൌണ്ടിലെ ഒരു കീ തയ്യാറാക്കി മൂന്നു രീതിയില്‍ അയയ്ക്കുക:

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/ മോ — 10,000 കോളുകൾ/മാസം, വാണിജ്യ ഉപയോഗം.
• ബിസിനസ് & ഡാഷ്; $49/mo — 1,00,000 കോളുകള്‍/മാസം, മുന്‍ഗണന, പ്രൊജക്ട്.

നിങ്ങളുടെ നിയമനത്തിനു വിരുദ്ധമായത്‌ എന്താണ്‌?

Only a successful response does. One 2xx = one call. Every error is free: a 400 for a misspelled parameter, a bad value or a missing required field, a 404 for an unknown slug, a 401 for a bad key, a 429, and anything that goes wrong on our side. Explore the contract and fix your request as many times as you need — you are billed for answers, not for corrections.

കാരണം തെറ്റുകള്‍ സ്വതന്ത്രമാണ്, പകരം അവ വിലയിടിവുകാരാണ്: ഒരു കീ കൂടുതല്‍ പ്രകോപിപ്പിക്കുന്നുണ്ടെങ്കില്‍ 200 rejected responses in an hour, it gets HTTP 429 "too_many_invalid_requests" until the hour rolls over. Successful calls never count towards that, so a working integration will never see it — it only catches a client stuck in a retry loop.

ഒരു കീയുടെ മാസിക ക്രമികരണം എച്ച്ടിപി 429 നല്‍കുമ്പോള്‍, "കമ_ എക്സ്‌സിക്യൂട്ട്" നല്‍കുന്നു; അപരിചിതമോ നിര്‍ജ്ജീവമോ ആയ കീ 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/ സൂചിക.