🔌 ھەقسىز ھېسابلىغۇچ API

ئومۇمىي

API تور بېكەتتە ئىشلىتىلگەن ماتېماتىكا بىلەن ئوخشاش. ھېسابلىغۇچنىڭ زېمىن قىممىتىنى سورۇن پارامېتىرلىرى ياكى JSON شەكلىدە ئەۋەتىپ، ھېسابلانغان نەتىجىلەرنى JSON شەكلىدە قايتۇرۇۋېلىپ، ھېسابلىغۇچ ئىشلەتكەن ھەرقانداق قىممەت ئۆسۈش ۋاقتى ياكى خەرىتىلەر سانلىق-مەلۇماتلىرىنى كىرگۈزىدۇ.

• 198+ ھېسابلىغۇچلار، ھەر بىرى ئۆزىنىڭ ئاخىرقى نۇقتىسى بار
• API ئاچقۇچى يوق — نامسىز قوزغاتقۇچ، IP نىڭ سۈرئىتى چەكلەنگەن
• CORS — Access-Control-Allow-Origin: * (خېرىدار تەرەپتىن ئىشلىتىش)
• سۈرئەتلىك چەكلىمى: 60 IP نىڭ ھەر سائەتتىكى سورۇنلىرى (ئۈچتىن ئاشقاندا HTTP 429)

ئاساسىي 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":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

دۆلەتكە ئاساسەن ھېسابلىغۇچلار (ئېقىپ بېرىش، قەرز، كىرىم-سېتىۋېلىش، سېتىش-سېتىۋېلىش...) قوبۇل قىلىنىدۇ ?country=us|uk|ca|au|in|ie|nz|za. نامەلۇم slug 404 نى قايتۇرىدۇ؛ قوللۇنمايدىغان دۆلەت ياكى خاتا كىرگۈزگۈچ 400 نى قايتۇرىدۇ، بۇدا ياردەمچى ئۇچۇر ۋە رايون خاراكتېرلىك ئۇچۇرلار بار.

ئىجازەت بېرىش ۋە پىلانى

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 سۈرئىتى چەكلەنگەن) ياكى ئايلىق ئازراق كوتىېت بىلەن ھەقسىز ئاچقۇچ. تىجارەتچىلەرگە ئىشلىتىلمەيدۇ.
• ئىجادىيەتچى — 100
• تىجارەت — $49/ئاي — 100

بىر ئاچقۇچنىڭ ئايلىق كوتىيەسى توشۇپ كەتكەندە 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);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

ھەممىسى ئاخىرلاشتۇرۇش

ھەر بىر ھېسابلىغۇچقا بىر ئاخىرلاشتۇرۇش نۇقتىسى. ھەر بىرىنىڭ زېمىن ئاچقۇچلىرى ۋە نەتىجە ئاچقۇچلىرى بۇ يەردە /api/v1/ ئىزنا.