🔌 အခမဲ့ဂဏန်းတွက်စက် API ကို

အကျဉ်းချုပ်

ဤ API ကို website ကိုအသုံးပြုသည်အတိအကျတူညီသောသင်္ချာ runs. query parameters များသို့မဟုတ် JSON အဖြစ်တွက်ချက်စက်၏ Field Values ကိုပို့ပြီး JSON အဖြစ်ပြန်ရဖို့တွက်ချက်ရလဒ်များကို - calculator ထုတ်လုပ်မည်သည့် amortization စီစဉ်ထားသို့မဟုတ် chart data ကိုအပါအဝင်.

• 198+ ဂဏန်းတွက်စက်, ၎င်း၏ကိုယ်ပိုင် endpoint တစ်ခုချင်းစီနှင့်အတူ
• API ကီးမရှိပါ — အမည်မဲ့ access, IP ကိုအားဖြင့်နှုန်း-ကန့်သတ်
• CORS — Access-Control-Allow-Origin: * (သုံးနိုင်သော client-side)
• နှုန်းထား ကနိမ့်ဆုံး: 60 IP ကိုတစ်ဦးလျှင်တောင်းဆိုချက်များ / နာရီ (HTTP ကို 429 ကျော်လွန်သောအခါ)

အခြေခံ URL

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

Index — စာရင်းတိုင်းဂဏန်းတွက်စက်

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

တစ်ခုချင်းစီကိုတစ်ဦး၏နယ်ပယ် (key ကို, label ကို, အမျိုးအစား, default, တပ်မတော်) နှင့်ရလဒ် key ကိုနှင့်အတူအားလုံးဂဏန်းတွက်စက်များ၏စက်-ဖတ်နိုင်စာရင်းပြန်လာ - dynamic အားဖြင့် client ကိုတည်ဆောက်ရန်လုံလောက်သော။

တွက်ချက်ခြင်း — တစ်ဂဏန်းတွက်စက်ကို run

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
}

တိုင်းပြည်-အသိအမှတ်ပြုဂဏန်းတွက်စက် ( mortgage, ချေးငွေ, ဝင်ငွေ-အခွန်, ရောင်းချ-အခွန်...) လက်ခံ ?country=us|uk|ca|au|in|ie|nz|za. အမည်မသိ slug 404 ပြန်လာ; မထောက်ခံတဲ့နိုင်ငံသို့မဟုတ်ဆိုး input ကိုပြန်လာ 400 ကူညီပေးနိုင်တဲ့သတင်းစကားနှင့် Field ကို Spec အတူ။

ခွင့်ပြုချက်နှင့် အစီအစဉ်များ

သင်သည်အဘယ်သူမျှမ key ကိုနှင့်အတူ API ကိုခေါ်ဆိုနိုင်ပါတယ် - အမည်မဲ့တောင်းဆိုမှုများ IP ကိုအားဖြင့်နှုန်းထား-ကန့်သတ်ထားသည်။ မြင့်မားသောအတွက်, ခန့်မှန်းနိုင်သောလစဉ် quota (နှင့်စီးပွားရေးလုပ်ငန်းအသုံးပြုမှု), သင့်ရဲ့အကောင့်စာမျက်နှာပေါ်တွင် key ကိုဖန်တီးပြီးသုံးနည်းလမ်းများထဲကတစ်ခုပို့:

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 ကိုနှုန်း-limited) သို့မဟုတ်အသေးစားလစဉ် quota နှင့်အတူအခမဲ့ key ကို. Non-ကုန်သွယ်.
• Developer — $9/လ — 10,000 calls/month, စီးပွားရေးလုပ်ငန်းသုံး။
• စီးပွားရေးလုပ်ငန်း — $49/month — 100,000 calls/month, အလိုအလျောက် ဖုန်းခေါ်ဆိုမှု

တစ်ဦးက key ကို၏လစဉ် quota ကိုအသုံးပြုတဲ့အခါ API ကိုပြန်လာ HTTP 429 မှားယွင်းမှုနှင့်အတူ "quota_exceeded"; အမည်မသိသို့မဟုတ်မလှုပ်ရှားသော key ကိုပြန်လာ 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}'

အဆုံးသတ်မှတ်တိုင်များ

တစ်ဦး endpoint တစ်ဂဏန်းတွက်စက်တစ်ဦး. Field က Keys တွေကိုနှင့်တစ်ဦးချင်းစီအတွက်ရလဒ်ကို Keys တွေကို /api/v1/ စာရင်းဇယား.