🔌 મુક્ત ગણકયંત્ર API

સમીક્ષા

API એ વેબસાઇટ વાપરે છે તે જ ગણિત ચલાવે છે. કેલ્ક્યુલેટરના ક્ષેત્રની કિંમતોને પ્રશ્ન પરિમાણો અથવા JSON તરીકે મોકલો અને ગણિતીય પરિણામોને JSON તરીકે પાછા મેળવો - કોઈપણ અધિગ્રહણ સમયગાળો અથવા આલેખ માહિતી કેલ્ક્યુલેટર ઉત્પન્ન કરે છે તે સમાવીને.

• 198+ ગણકયંત્રો, દરેક તેની પોતાની અંતબિંદુ સાથે
• API કી નથી — અનામિક પ્રવેશ, IP દ્દારા દર-સીમિત
• CORS — Access-Control-Allow-Origin: * (વપરાશકર્તા-બાજુ વાપરી શકાય તેવું ક્લાયન્ટ)
• દર મર્યાદા: 60 IP પ્રતિ વિનંતી/કલાક (HTTP ૪૨૯ જ્યારે વધે છે)
• ભૂલો મુક્ત છે — ફક્ત સફળ (2xx) જવાબ તમારા મહિનાના કોટામાંથી એક કોલ વાપરે છે. દરેક 400, 401, 404, 429 અને 500 તમને કંઇ ખર્ચ કરે છે.

આધાર 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":   { ... 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 સાચી રીતે ઉકેલી શકતું નથી તે ભૂલ છે, કદી શૂન્ય નથી: ભૂલથી લખાયેલ પરિમાણ, ખોટા પ્રકારની કિંમત, અજ્ઞાત ડ્રોપડાઉન વિકલ્પ, અથવા ગુમ થયેલ ક્ષેત્ર કે જે મૂળભૂત નથી (તારીખ ક્ષેત્રો - જન્મ તારીખ ધારી શકાતી નથી). દરેક ૪૦૦ નામો અપરાધ પરિમાણ અને સંપૂર્ણ ક્ષેત્ર સ્પષ્ટતાને યાદ કરે છે જેથી ક્લાયન્ટ પોતાને સુધારી શકે.

$ 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, અજ્ઞાત સ્લેગ માટે 404, ખરાબ કી માટે 401, 429, અને કંઈપણ જે આપણી બાજુ પર ખોટી રીતે જાય છે. કરારને શોધો અને તમારી વિનંતી કેટલીક વાર જરૂરી હોય તેટલી સુધારો - તમે જવાબો માટે બિલ કરવામાં આવે છે, સુધારાઓ માટે નહિં.

કારણ કે ભૂલો મુક્ત છે તેઓ બદલે દર-સમૂહિત છે: જો એક કી કરતાં વધારે પ્રેરિત કરે છે 200 કલાકમાં નકારાયેલ પ્રત્યુત્તરો, તે HTTP 429 "too_many_invalid_requests" મેળવે છે જ્યાં સુધી કલાક ઉપર નહિં ફેરવાય. સફળ કોલ્સ એ તરફ ગણતરી કરે છે, તેથી કામ કરતુ સંકલન તેને ક્યારેય જોશે નહિં - તે ફક્ત ક્લાયન્ટને ફરીથી પ્રયત્ન લૂપમાં અટવાઇ ગયેલ છે.

જ્યારે કીનું માસિક કોટા વપરાયું હોય ત્યારે 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/ અનુક્રમણિકા.