🔌 Хэмжих хэрэгсэл

Тодорхойлолт

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. Тодорхойгүй бөглөрөл 404- ийг буцаана; дэмжигдээгүй улс эсвэл буруу оруулсан мэдээлэл нь 400- ийг буцаана. Энэ нь туслах мэдээллийг агуулж, талбарын тодорхойлолтыг агуулна.

Ангилал

Та API-г түлхүүргүйгээр дуудах боломжтой - нууц үггүй хүсэлтүүд IP-ээр хязгаарлагддаг. Хэрэв та сарын квотыг (эсвэл бизнесийн зорилгоор ашиглах) нэмэгдүүлэхийг хүсвэл, дансны хуудаснаас түлхүүр үүсгэж, дараах3аргаар илгээнэ үү:

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 дуудлага/сар, нэн тэргүүний дамжуулалт.

Товчны сарын квота дууссан үед 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/ индекс.