🔌 ਮੁਫਤ ਕੈਲਕੁਲੇਟਰ API

ਝਲਕ

API ਵੈੱਬਸਾਈਟ ਵਾਂਗ ਹੀ ਗਣਿਤ ਚਲਾਉਦਾ ਹੈ। ਕੈਲਕੁਲੇਟਰ ਦੇ ਖੇਤਰ ਮੁੱਲ ਨੂੰ ਕਿਊਰੀ ਪੈਰਾਮੀਟਰ ਜਾਂ 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/

ਸਭ ਕੈਲਕੂਲੇਟਰਾਂ ਦੀ ਇੱਕ ਮਸ਼ੀਨ- ਪੜ੍ਹਨਯੋਗ ਲਿਸਟ ਹਰੇਕ ਖੇਤਰ (ਕੁੰਜੀ, ਲੇਬਲ, ਕਿਸਮ, ਡਿਫਾਲਟ, ਯੂਨਿਟ) ਅਤੇ ਨਤੀਜੇ ਕੁੰਜੀਆਂ ਨਾਲ ਵਾਪਸ ਦਿੰਦਾ ਹੈ - ਕਲਾਂਇਟ ਨੂੰ ਡਾਇਨਾਮਿਕ ਢੰਗ ਨਾਲ ਬਣਾਉਣ ਲਈ ਕਾਫ਼ੀ ਹੈ । ਹਰੇਕ ਖੇਤਰ ਇੱਕ ਲੋੜੀਦਾ ਫਲੈਗ ਵੀ ਰੱਖਦਾ ਹੈ - ਕੁਝ ਖੇਤਰਾਂ ਲਈ ਠੀਕ ਹੈ, ਜੋ ਕਿ ਕੋਈ ਡਿਫਾਲਟ ਨਹੀਂ ਹਨ (ਮਿਆਦ, ਜ਼ਿਆਦਾਤਰ) । ਉਹ ਭੇਜੋ: ਕੁਝ ਕੈਲਕੂਲੇਟਰ ਇੱਕ ਨੂੰ ਸਮਝ ਸਕਦੇ ਹਨ, ਬਾਕੀ ਜਵਾਬ400 ਬਿਨਾਂ ਹੈ ।

ਗਣਨਾ — ਇੱਕ ਕੈਲਕੂਲੇਟਰ ਚਲਾਓ

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 ਜੋ ਵੀ ਠੀਕ ਤਰ੍ਹਾਂ ਹੱਲ਼ ਨਹੀਂ ਕਰ ਸਕਦਾ ਹੈ ਉਹ ਗਲਤੀ ਹੈ, ਕਦੇ ਵੀ ਸ਼ੂਗਰ ਨਹੀਂ: ਗਲਤ ਸ਼ਬਦ- ਜੋੜ ਪੈਰਾਮੀਟਰ, ਗਲਤ ਕਿਸਮ ਦਾ ਮੁੱਲ, ਅਣਜਾਣ ਡਰੋਪ- ਡਾਊਨ ਚੋਣ, ਜਾਂ ਗੁੰਮ ਫੀਲਡ, ਜਿਸ ਦਾ ਕੋਈ ਡਿਫਾਲਟ ਨਹੀਂ ਹੈ (ਮਿਤੀ ਖੇਤਰ - ਜਨਮ ਮਿਤੀ ਨੂੰ ਅੰਦਾਜ਼ਾ ਨਹੀਂ ਲਗਾਇਆ ਜਾ ਸਕਦਾ) । ਹਰ 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/ ਇੰਡੈਕਸ ਹਰੇਕ ਖੇਤਰ ਦੀ ਕੁੰਜੀ, ਕਿਸਮ, ਯੂਨਿਟ, ਡਿਫਾਲਟ ਅਤੇ ਕੀ ਲੋੜੀਦਾ ਹੈ, ਨੂੰ ਪਬਲਿਸ਼ ਕਰਦਾ ਹੈ - ਇੱਕ ਕਲਾਂਇਟ ਬਣਾਉਣ ਲਈ ਕਾਫ਼ੀ ਹੈ, ਜੋ ਕਿ ਕਦੇ ਵੀ ਅੰਦਾਜ਼ਾ ਨਹੀਂ ਲਗਾਉਂਦਾ ਹੈ ।

ਪਰਮਾਣਕਿਤਾ ਅਤੇ ਯੋਜਨਾਵਾਂ

ਤੁਸੀਂ 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/mo — 10,000 ਕਾਲਾਂ/ਮਹੀਨਾ, ਵਪਾਰਕ ਵਰਤੋਂ
• ਵਪਾਰਕ — $49/ਮਹੀਨਾ — 100,000 ਕਾਲਾਂ/ਮਹੀਨਾ, ਤਰਜੀਹੀ ਟ੍ਰਾਂਸਪੋਰਟ

ਤੁਹਾਡੇ ਕੋਟਾ ਨਾਲ ਕੀ ਗਿਣਤੀ ਹੈ

ਕੇਵਲ ਸਫਲ ਜਵਾਬ ਹੀ ਹੈ । ਇੱਕ 2xx = ਇੱਕ ਕਾਲ ਹੈ । ਹਰ ਗਲਤੀ ਮੁਫ਼ਤ ਹੈ: ਗਲਤ ਸ਼ਬਦ- ਜੋੜ ਪੈਰਾਮੀਟਰ ਲਈ 400, ਗਲਤ ਮੁੱਲ ਜਾਂ ਗੁੰਮ ਹੋਏ ਲੋੜੀਦੇ ਖੇਤਰ ਲਈ 404, ਅਣਜਾਣ ਸਲਾਗ ਲਈ 404, ਗਲਤ ਕੁੰਜੀ ਲਈ 401, 429, ਅਤੇ ਸਾਡੇ ਪਾਸੇ ਤੋਂ ਜੋ ਵੀ ਗਲਤ ਹੋ ਜਾਵੇ । ਸੰਧੀ ਦੀ ਖੋਜ ਕਰੋ ਅਤੇ ਆਪਣੀ ਮੰਗ ਨੂੰ ਜਿੰਨੀ ਵਾਰੀ ਚਾਹੋ ਸੁਧਾਰੋ — ਤੁਹਾਨੂੰ ਜਵਾਬ ਲਈ ਬਿੱਲ ਦਿੱਤਾ ਜਾਵੇਗਾ, ਸੋਧ ਲਈ ਨਹੀਂ ।

ਕਿਉਂਕਿ ਗਲਤੀਆਂ ਮੁਫ਼ਤ ਹਨ, ਇਸ ਲਈ ਉਹ ਰੇਟ- ਲਿਮਟਡ ਹਨ: ਜੇਕਰ ਇੱਕ ਸਵਿੱਚ ਤੋਂ ਵੱਧ ਝਟਕਦੀ ਹੈ 200 ਇੱਕ ਘੰਟੇ ਵਿੱਚ ਜਵਾਬ ਰੱਦ ਕੀਤੇ, ਇਹ HTTP 429 "too_many_invalid_requests" ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ, ਜਦੋਂ ਤੱਕ ਕਿ ਘੰਟਾ ਖਤਮ ਨਹੀਂ ਹੋ ਜਾਂਦਾ ਹੈ। ਸਫਲ ਕਾਲਾਂ ਇਸ ਲਈ ਗਿਣਤੀ ਨਹੀਂ ਹੁੰਦੀਆਂ, ਇਸ ਲਈ ਕੰਮ ਕਰਨ ਵਾਲਾ ਇੱਕਜੁਟਤਾ ਕਦੇ ਵੀ ਵੇਖਿਆ ਨਹੀਂ ਜਾ ਸਕਦਾ ਹੈ - ਇਹ ਸਿਰਫ ਇੱਕ ਕਲਾਂਇਟ ਨੂੰ ਇੱਕ ਮੁੜ-ਤਜਰਬੇ ਲੂਪ ਵਿੱਚ ਫੜਦਾ ਹੈ।

ਜਦੋਂ ਇੱਕ ਕੁੰਜੀ ਦਾ ਮਹੀਨਾਵਾਰ ਕੋਟਾ ਖਤਮ ਹੋ ਜਾਵੇ ਤਾਂ 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/ ਇੰਡੈਕਸ.