🔌 ವೀಕ್ಷಣೆ ಲೆಕ್ಕಾಚಾರದ API

ವಿಲೋಮ

API ವೆಬ್‌ಸೈಟ್‍ನ ಬಳಕೆಯ ನಿಖರವಾದ ಲೆಕ್ಕವನ್ನು ನಿರ್ವಹಿಸುತ್ತದೆ. ಮನಃಪೂರ್ವಕ ಅಂಕಿಅಂಶಗಳು ಅಥವ JSON ಗೆ ಕ್ಯಾಲ್ಕುಲೇಟರ್‌ಗಳೆಂದು ಒಂದು ಕ್ಯಾಮೆಟ್‌ನ ಮೌಲ್ಯಗಳನ್ನು ಕಳುಹಿಸಿ ನಂತರ JSon ಎಂದು ಲೆಕ್ಕಾಚಾರದ ಫಲಿತಾಂಶಗಳನ್ನು ಪಡೆದುಕೊಳ್ಳಿ —⁠ ಯಾವುದೇ ಅನಿಕ್ರಮಣೆ షెడೇಟ್‌ ಅನ್ನು ಒಳಗೊಂಡು ಕ್ಯಾಲ್ಕುಲೇಟರ್‌ ಅನ್ನು ಉತ್ಪಾದಿಸುತ್ತದೆ.

• 198+ ಕ್ಯಾಲ್ಕುಲೇಟರ್, ಪ್ರತಿಯೊಂದು ತನ್ನದೇ ಅಂತ್ಯದ ಬಿಂದುವಿರುವ
• API ಕೀಲಿಯು ಇಲ್ಲ — ಅನಾಮಧೇಯ ನಿಲುಕಣೆ, IP ನಿಂದ ವಿಸ್ತರಣಾ ವಿಸ್ತರಣಾ (transm)
• CORS — Access-Control-Allow-Origin: * (usable client-side)
• ಮಿತಿ: 60 ಮನವಿಗಳು/ఘುರಳೆ (ಎച്ച്ടിP 429)
• ದೋಷಗಳು ಖಾಲಿ ಇವೆ — only a successful (2xx) response uses one call from your monthly quota. Every 400, 401, 404, 429 and 500 costs you nothing.

ಮೂಲ URL

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

ಸೂಚಿ — ಪ್ರತಿಯೊಂದು ಕ್ಯಾಲ್ಕುಲೇಟರ್ ಪಟ್ಟಿ

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

ಎಲ್ಲಾ ಕಾಲಂಗಳನ್ನು (key, ಗುರುತು, ಬಗೆ, ಪೂರ್ವನಿಯೋಜಿತ, ಏಕತೆ) ಮತ್ತು ಫಲಿತಾಂಶದ ಕೀಲಿಕೈಗಳೊಂದಿಗೆ ಮರಳಿಸುತ್ತದೆ. ಇದು ಸೇವನಾರ್ಥಿಯನ್ನು ಸಕ್ರಿಯವಾಗಿ ಕಟ್ಟಲು ಸಾಕಾಗುತ್ತದೆ. Each field also carries a required flag — true for the few fields that have no default (dates, mostly). Send those: a couple of calculators can infer one, the rest answer 400 without it.

ಲೆಕ್ಕಹಾಕು —⁠ ಒಂದು ಕ್ಯಾಲ್ಕುಲೇಟರ್‌ ಅನ್ನು ಚಲಾಯಿಸು

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":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

ದೇಶ-ಗೋಚರ ಕ್ಯಾಲ್ಕುಲೇಟರ್‌ಗಳು (ಮೋರ್ಜೆ, ಸಾಲ, ಆದಾಯ-ಟಾಕ್ಸ್, ಮಾರಾಟ-ಟಾಕ್ಸ್ ಅಂಗೀಕರಿಸು...) ?country=us|uk|ca|au|in|ie|nz|za. ಗೊತ್ತಿರದ ನೋಂದಣಿ 404 ನ್ನು ಹಿಂದಿರುಗಿಸುತ್ತದೆ; ಬೆಂಬಲವಿಲ್ಲದ ದೇಶ ಅಥವ ಕೆಟ್ಟ ಇನ್‌ಪುಟ್ 400 ಅನ್ನು ಸಹಾಯಕರ ಸಂದೇಶದೊಂದಿಗೆ ಮರಳಿಸುತ್ತದೆ ಮತ್ತು ಕ್ಷೇತ್ರದ ಕಸ್ಟಮೈಸ್‌ದೊಂದಿಗೆ.

ಪ್ರಮಿತಿಗಳು, ಪೂರ್ವನಿಯೋಜಿತಗಳು ಮತ್ತು ದೋಷಗಳು

ನೀವು ಬಿಡುವ ಹೊಲಗಳನ್ನು ಮಾತ್ರ ಕಳುಹಿಸು. ನೀವು ಯಾವ ದೇಶಕ್ಕೆ ಹೋಗಲಿ, ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ ಆ ಕ್ಷೇತ್ರದಲ್ಲಿ ಪ್ರಕಾಶಿಸಲಾದ ಪೂರ್ವನಿಯೋಜಿತದ ಡೀಪಲ್ ಅನ್ನು ಮಾತ್ರ ಕಳುಹಿಸಿರಿ. ಇದು ಕ್ಯಾಲುಕೇಟ್ ಪುಟದ ಅದೇ ಮೌಲ್ಯ, ಆದ್ದರಿಂದ API ಹಾಗು ವೆಬ್ಸೈಟ್ ಒಂದೇ ನಮೂದುಗಳಿಗೆ ಯಾವಾಗಲೂ ಒಂದೇ ಸಂಖ್ಯೆಯನ್ನು ಮರಳಿಕೊಡುತ್ತವೆ. ಪ್ರತಿ ಉತ್ತರವು, ಇದು ಕೆಳಭಾಗದಲ್ಲಿ ಏನನ್ನು ತುಂಬಿಸಿದೆಯೋ ಅದನ್ನು ಪಟ್ಟಿ ಮಾಡುತ್ತದೆ. defaults_applied.

API ಅನ್ನು ಪ್ರಾಮಾಣಿಕವಾಗಿ ನಿರ್ಧರಿಸಲು ಸಾಧ್ಯವಿಲ್ಲದಂತಹ ಯಾವುದೇ ಒಂದು ದೋಷವು, ಒಂದು 0 ಸೂಚಕವು: ಒಂದು ದೋಷ, ಒಂದು ಶೂನ್ಯ ಮೌಲ್ಯ, ಅಜ್ಞಾತ ಬಗೆಯ ಆಯ್ಕೆ, ಪೂರ್ವನಿಯೋಜಿತ (ಹೇడ) —⁠ ಒಂದು ದಿನಾಂಕ —⁠ ದೋಷದ (ಮೃತೀಯ) ಸಾಲು (ಹೇವಲ್ ಕಾಲ) ಅಥವ ಕಾಣದ (ಮಳೆ) ಕ್ಷೇತ್ರಗಳು (ಆಧಿಯ ದಿನಾಂಕ) ಕಾಣದ) ಒಂದು ಹೊಲ. ಪ್ರತಿ 400 ಹೆಸರುಗಳು ದೋಷಪೂರ್ಣವಾದ ಗೂಢಲಿಪನೆಯನ್ನು ಸೂಚಿಸುತ್ತದೆ ಹಾಗು ಸೇವನಾರ್ಥಕವನ್ನು ಪ್ರತಿ ಸೇವನೆಗಾರವು ತನ್ನಷ್ಟಕ್ಕೆ ಸರಿಯಾಗಿದೆ.

$ 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/ ಸೂಚಿಯು ಪ್ರತಿಯೊಂದು ಕ್ಷೇತ್ರದ ಕೀಲಿಕೈ, ಬಗೆ, ಏಕತೆ, ಪೂರ್ವನಿಯೋಜಿತ, ಮತ್ತು ಅಗತ್ಯವಿದ್ದರೆ ಇದನ್ನು ಪ್ರಕಟಿಸುತ್ತದೆ. ಎಂದಿಗೂ ಅಳೆಯದ ಸೇವನಾರ್ಥಿಯನ್ನು ನಿರ್ಮಿಸಲು ಸಾಕಾಗುತ್ತದೆ.

ದೃಢೀಕರಣ (amp; ಪ್ಲಾಕಿಂಗ್); ಪ್ಲಾಕಗಳು

ನೀವು 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"

• ಉಚಿತ — ಅನಾಮಧೇಯ (ವಿಂಡೆ- ವಿತ್ಯಾಜ್ಯ) ಅಥವ ಒಂದು ಉಚಿತವಾದ ತಿಂಗಳ ನಿಯೋಜನೆ (ಸಿಪ್ಸ್- ರೇಟ್). ಅನಾಮಧೇಯ (ವಿಂಡೆ- ವಿನಿಮಯ).
• ವಿಕಾಸಕ( Mdash; $9/ mo) — 10,000 ಕರೆಗಳು/ ತಿಂಗಳಿಗೆ, ವ್ಯಾಪಾರದ ಬಳಕೆ.
• ವ್ಯಾಪಾರ & ಡೇಡ್‌ಮಾರ್; $49/ ಮೋm — 1,00,000 ಕರೆಗಳು/ ತಿಂಗಳಿಗೆ, ಮೊದಲಿಗೆ whatch

ನಿಮ್ಮ ಕರ್ತವ್ಯಕ್ಕೆ ಸಂಬಂಧಿಸಿದ ವಿಷಯಗಳು

Only a successful response does. One 2xx = one call. Every error is free: a 400 for a misspelled parameter, a bad value or a missing required field, a 404 for an unknown slug, a 401 for a bad key, a 429, and anything that goes wrong on our side. Explore the contract and fix your request as many times as you need — you are billed for answers, not for corrections.

ಯಾಕಂದರೆ ಅವು ಮಿತಪ್ರಮಾಣದಲ್ಲಿವೆ. ಒಂದು ಕೀಲಿಕೈ ಇದಕ್ಕಿಂತ ಹೆಚ್ಚಿನವಾಗಿ ಉದ್ರೇಕಿಸುತ್ತದೆ. 200 rejected responses in an hour, it gets HTTP 429 "too_many_invalid_requests" until the hour rolls over. Successful calls never count towards that, so a working integration will never see it — it only catches a client stuck in a retry loop.

ಒಂದು ಕೀಲಿಯ ಮಾಸಿಕ ಹಂಚಿಕೆ(ಸ್ಟಾರ್ಟ್) ಅನ್ನು ಬಳಸಿದಾಗ, HTTP_ ೪29 ನ್ನು ದೋಷದೊಂದಿಗೆ ಹಿಂದಿರುಗಿಸುತ್ತದೆ, ಇದು "ಕನ್ನ_ ಎಕ್ಸ್‌ಸೆಡ್ಡ್‌"; ಒಂದು ಗೊತ್ತಿಲ್ಲದ ಅಥವಾ ನಿಷ್ಕ್ರಿಯವಾದ ಕೀಲಿಕೈ HTTP 401 ಅನ್ನು ಮರಳಿ ತರುತ್ತದೆ. [ ಪುಟ 13ರಲ್ಲಿರುವ ಚಿತ್ರ] ಪ್ರಸ್ತಾಪ ಪುಟ.

ಉದಾಹರಣೆಗಳು

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/ ಸೂಚಿ.