🔌 ነጻ ካልኩሌተር

ማጠቃለያ

የ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. ያልታወቀው ሱልግ 404 ይመለሳል፤ ያልተደገፈ ሀገር ወይም መጥፎ መዝገብ ቤት 400 በረዳት መልዕክት እና በፍለጋ መስክ ልዩነት ይመለሳል

መተላለፊያ

የእርስዎን ፍላጎት የሚመለከቱትን መስኮቶች ብቻ ላክ. የትኛውንም ካላስቀመጡት በዚያ መስክ ውስጥ የተጻፈው መነሻ ነው - ተመሳሳይ ዋጋ የቁጥጥር ገጽ ቀድሞ-ይሞላ, ስለዚህ API እና ድረ ገጽ ሁልጊዜ ተመሳሳይ ቁጥሮችን ለተመሳሳይ መሳሪያዎች ይመልሳል. መልስ ሁሉ በታች የተሞላውን ዝርዝር ይሰጣል defaults_applied.

API በፍጹም ሊፈታ የማይችል ነገር ሁሉ ስህተት ነው፣ ፈጽሞ ስድብ አይደለም፡ የተጻፈው ስህተት የፓራሜትር፣ የክፉ ዓይነት ዋጋ፣ ያልታወቀ የወረደ ምርጫ፣ ወይም የሌለው የቀድሞው የሌለው ሜዳ (የቀን ሜዳዎች - የልደት ቀን ሊጠረጠር አይችልም)። በየ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/ index የእያንዳንዱን የፍሬም ቁልፍ፣ ዓይነት፣ ዩኒት፣ ቅድመ-ሁኔታ እና አስፈላጊ ከሆነው ይለጥፋል - ሁልጊዜ የማይጠረጥሩ ክላሲክ ለመገንባት በቂ ነው

ማረጋገጫ

የ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 ፍጥነት-ተወሰነ) ወይም ነጻ ቁልፍ በትንሽ ወርሃዊ ኮታ. ያልተሸጠ.
• Developer — $9/mo — 10,000 ጥሪዎች/ወር፣ የቢዝነስ ጥቅም
• Business — $49/mo — 100,000 ጥሪዎች / ወር, ትኩረት ትራንስፖርት.

የኮቶን

የፈተናው ውጤት ብቻ ነው የሚያደርገው. አንድ 2xx = አንድ ጥሪ. ስህተት ሁሉ ነጻ ነው: 400 ለ ስህተት የተጻፈው ማራሚድ, መጥፎ ዋጋ ወይም የሌለ ያስፈልጋል ሜዳ, 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/ መደርደሪያ.