🔌 ຕົວຄິດໄລ່​ຟຣີ

ເບິ່ງ​ລວມ

API ແລ່ນຄະນິດສາດທີ່ແນ່ນອນດຽວກັນທີ່ເວັບໄຊທ໌ໃຊ້. ສົ່ງຄ່າ Field ຂອງເຄື່ອງຄິດໄລ່ເປັນຄໍາຖາມປາຣາເມັດຫຼື 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/

ສົ່ງ​ຄືນ​ລາຍ​ຊື່​ທີ່​ສາມາດ​ອ່ານ​ໄດ້​ໂດຍ​ເຄື່ອງ​ຂອງ​ເຄື່ອງ​ຄິດໄລ່​ທັງ​ໝົດ​ພ້ອມ​ກັບ​ແຫລ່ງ​ຂໍ້ມູນ​ຂອງ​ແຕ່ລະ​ອັນ (ປຸ່ມ, ស្លាກ, ປະເພດ, ຕົວ​ແບບ, ໜ່ວຍ) ແລະ​ປຸ່ມ​ຜົນ — ພຽງພໍ​ທີ່ຈະ​ສ້າງ​ແຄມເປນ​ແບບ​ດັ້ງເດີມ​ໄດ້. ທຸກໆພື້ນທີ່ຍັງໄດ້ນໍາເອົາດາວໂຫລດທີ່ຕ້ອງການ - ຈິງສໍາລັບບາງພື້ນທີ່ທີ່ບໍ່ມີການຕັ້ງຄ່າແບບຈໍາລອງ (ວັນ, ສ່ວນໃຫຍ່). ສົ່ງພວກ: ສອງເຄື່ອງຄິດໄລ່ສາມາດ infer ຫນຶ່ງ, ຄໍາຕອບທີ່ເຫຼືອ 400 ໂດຍບໍ່ມີມັນ.

ຄິດໄລ່ - ແລ່ນ​ເຄື່ອງ​ຄິດໄລ່​ດຽວ

GET  https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/     (JSON or form body)

ຮູບ​ແບບ​ການ​ຕອບ​ໂຕ້ & # 160; ៖

{
  "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"]
}

ຕົວຄິດໄລ່ທີ່ຮູ້ຈັກປະເທດ ( mortgage, ເງິນກູ້, ລາຍໄດ້-ພາສີ, ຂາຍ-ພາສີ...) ຍອມຮັບ ?country=us|uk|ca|au|in|ie|nz|za. ບໍ່ຮູ້ slug ສົ່ງຄືນ 404; ບໍ່​ໄດ້​ສະໜັບສະໜູນ​ປະເທດ ຫຼື ຂໍ້ມູນ​ເຂົ້າ​ມາ​ຜິດ ສົ່ງຄືນ 400 ດ້ວຍການ​ສົ່ງຂໍ້ຄວາມ​ທີ່​ມີ​ປະໂຫຍດ ແລະ ຂໍ້​ກຳນົດ​ພື້ນທີ່.

ພາຣາມັຕ, ຕົວ​ເລກ​ປັ໊ກ​ອິນ ແລະ​ຂໍ້ຜິດພາດ

ສົ່ງ​ພຽງແຕ່​ພື້ນທີ່​ທີ່​ທ່ານ​ສົນໃຈ​ເທົ່ານັ້ນ. ທຸກ​ສິ່ງ​ທີ່​ທ່ານ​ປ່ອຍ​ອອກ​ໄປ​ແມ່ນ​ຈະ​ຖືກ​ຕື່ມ​ດ້ວຍ​ການ​ປ່ອຍ​ຕົວ​ແບບ​ເດີມ​ຂອງ​ພື້ນທີ່​ນັ້ນ - ຄ່າ​ດຽວກັນ​ທີ່​ໜ້າ​ກົນໄກ​ຄິດໄລ່​ຕື່ມ​ກ່ອນ, ສະນັ້ນ API ແລະ​ເວບ​ໄຊ​ທ໌​ຈະ​ສົ່ງ​ຄືນ​ຕົວເລກ​ທີ່​ຄື​ກັນ​ກັບ​ການ​ເຂົ້າ​ເຖິງ​ທີ່​ຄື​ກັນ​ສະເໝີ. ການ​ຕອບ​ໂຕ້​ແຕ່ລະ​ອັນ​ຈະ​ລາຍ​ຊື່​ສິ່ງທີ່​ມັນ​ໄດ້​ຕື່ມ​ຢູ່​ພາຍ​ໃຕ້ defaults_applied.

ທຸກສິ່ງທຸກຢ່າງ API ບໍ່ສາມາດແກ້ໄຂຢ່າງຈິງຈັງແມ່ນຂໍ້ຜິດພາດ, ບໍ່ເຄີຍເປັນສະກຸນ: ຕົວກໍານົດການ spelling ຜິດ, ມູນຄ່າຂອງປະເພດຜິດ, ທາງເລືອກ dropdown ທີ່ບໍ່ຮູ້ຈັກ, ຫຼື field missing that has no default (the date fields -abirth date cannot be guessed). Every 400 names the offending parameter and echoes the full field spec so a client can correct itself.

$ 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 ສໍາລັບຕົວກໍານົດການ spelling ຜິດ, ຄ່າທີ່ບໍ່ດີຫຼືຂາດທີ່ຈໍາເປັນ field, 404 ສໍາລັບ slug ບໍ່ຮູ້, 401 ສໍາລັບປຸ່ມບໍ່ດີ, 429, ແລະທຸກສິ່ງທຸກຢ່າງທີ່ໄປຜິດພາດໃນດ້ານຂອງພວກເຮົາ. ຄົ້ນຫາສັນຍາແລະແກ້ໄຂຄໍາຮ້ອງຂໍຂອງທ່ານຫຼາຍຄັ້ງທີ່ທ່ານຕ້ອງການ - ທ່ານຖືກຄິດຄ່າບໍລິການສໍາລັບການຕອບ, ບໍ່ສໍາລັບການແກ້ໄຂ.

ຍ້ອນ​ວ່າ​ຂໍ້ຜິດພາດ​ແມ່ນ​ຟຣີ ພວກເຂົາ​ຖືກ​ຈໍາກັດ​ດ້ວຍ​ອັດຕາ​ແທນ​ທີ່​ຈະ: ຖ້າ​ປຸ່ມ​ດຽວ​ກໍ່​ເກີດ​ຂຶ້ນ​ຫຼາຍ​ກວ່າ 200 ຄໍາຕອບທີ່ປະຕິເສດໃນຫນຶ່ງຊົ່ວໂມງ, ມັນໄດ້ຮັບ HTTP 429 "too_many_invalid_requests" ຈົນກ່ວາຊົ່ວໂມງ rolls ຂຶ້ນ. ການໂທທີ່ປະສົບຜົນສໍາເລັດບໍ່ເຄີຍຄິດໄລ່ໄປທີ່ນັ້ນ, ດັ່ງນັ້ນການລວມເຂົ້າເຮັດວຽກຈະບໍ່ເຄີຍເຫັນມັນ - ມັນພຽງແຕ່ຈັບລູກຄ້າຕິດຢູ່ໃນລວດພະຍາຍາມຄືນ.

ເມື່ອ​ກູ​ໂກ​ໃຊ້​ໄດ້​ຕາມ​ຄັອບ​ເຕີ​ 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/ ລາຍ​ການ​ບັນທຶກ.