🔌 கணிப்பொறி

பொதுவான

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": [ ... ]
}

The /api/v1/ index ஒவ்வொரு புலத்தின் விசை, வகை, அலகு, முன்னிருப்பு மற்றும் தேவைப்படுகிறதா என்பதை வெளியிடுகிறது - ஒரு வாடிக்கையாளர் எப்போதும் யூகிக்காததை உருவாக்க போதுமானது.

உரிமம் & திட்டங்கள்

நீங்கள் விசை இல்லாமல் 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/-, 100,0

உங்கள் வரிசைப்படுத்தலுக்கு எதிராக என்ன கணக்கிடப்படுகிறது

வெற்றிகரமான பதில் மட்டுமே. ஒரு 2xx = ஒரு அழைப்பு. ஒவ்வொரு பிழையும் இலவசம்: ஒரு 400 தவறாக எழுதப்பட்ட அளவுரு, ஒரு தவறான மதிப்பு அல்லது தேவையான புலத்தை இழந்த, ஒரு 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/ சுட்டுவரிசை.