🔌 Libreng Calculator API

Pangkalahatang-ideya

Ipadala ang mga halaga ng patlang ng isang kalkulador bilang mga parameter ng query o JSON at makuha ang mga na-compute na resulta pabalik bilang JSON — kabilang ang anumang amortization schedule o chart data na ginawa ng kalkulador.

• 198+ calculators, ang bawat isa na may sariling endpoint
• Walang API key — anonymous access, rate-limited sa pamamagitan ng IP
• CORS — Access-Control-Allow-Origin: * (magagamit client-side)
• Rate limit: 60 mga kahilingan / oras bawat IP (HTTP 429 kapag lumampas)

Base URL

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

Index — listahan ng bawat kalkulador

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

Ang mga ito ay maaaring maging mga yunit ng pagsukat (i.e., mga unit ng sukat, mga unit ng sukat, mga unit ng sukat, mga unit ng sukat, at iba pa).

Compute — patakbuhin ang isang calculator

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

Tugon hugis:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Country-aware calculators (mortgage, pautang, kita-tax, benta-tax...) tanggapin ?country=us|uk|ca|au|in|ie|nz|za. Ang 404 (apat na daan at apat na pu) ay isang likas na bilang na pagkatapos ng 403 at bago ng 404.

Pag-authenticate & mga plano

Maaari mong tawagan ang API na walang key sa lahat - anonymous mga kahilingan ay rate-limited sa pamamagitan ng IP. Para sa isang mas mataas na, predictable buwanang quota (at komersyal na paggamit), lumikha ng isang key sa iyong pahina ng account at ipadala ito sa isa sa tatlong paraan:

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"

• Libre — anonymous (IP rate-limited) o isang libreng key na may isang maliit na buwanang quota. Non-commercial.
• Developer — $9/buwan — 10,000 tawag/buwan, komersyal na paggamit.
• Negosyo — $49/buwan — 100,000 tawag/buwan, prayoridad na throughput.

Ang mga sumusunod na mga halimbawa ay nagpapakita ng mga halimbawa ng mga karaniwang mga error sa HTTP: Ang HTTP 429 ay isang error na hindi nakikita ng mga server. Tingnan ang buong mga plano at mag-sign up sa Pagpepresyo Pahina.

Mga halimbawa

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}'

Lahat ng endpoints

Isang endpoint bawat calculator. Patlang key at resulta key para sa bawat isa ay sa /api/v1/ Index.