🔌 מחשבון חינם API

סקירה

API מפעיל את אותה המתמטיקה המדויקת שבה משתמש האתר. שלח את ערכי השדה של המחשבון כערכי שאילתה או ג'ייסון ולקבל את התוצאות החישוביות בחזרה כ-JSON ▪ כולל כל לוח זמנים של אמוטיזציה או נתוני תרשים שהמחשבון מייצר.

• 198+ מחשבונים, כל אחד עם נקודת קצה משלו
• אין מפתח API — גישה אנונימית, שיעור מוגבל על ידי IP
• CORS — Access-Control-Allow-Origin: * (לקוח זמין)
• רמת הגבלת קצב: 60 בקשות/ שעה ל- IP (HTTP 429 כאשר חרג)
• שגיאות הן בחינם — כל 400, 401, 404, 429 ו-500 לא עולים לך כלום.

כתובת בסיס

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/ אינדקס מפרסם את כל מפתח השדה, סוג, יחידה, ברירת מחדל והאם נדרש מספיק כדי לבנות לקוח שלעולם לא מנחש.

אימות ותוכניות

ניתן לקרוא ל-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-Limited) או מפתח חינם עם מכסה חודשית קטנה.
• מפתח & mdash; 9/mo — 10,000 שיחות/חודש, שימוש מסחרי.
• עסקים & מדש; 49/ מו — מאה אלף שיחות/חודשים, עדיפות דרך.

מה שחשוב נגד המכסה שלך

כל שגיאה היא חופשית: 400 עבור פרמטר מאוית שגוי, ערך רע או שדה נדרש חסר, 404 עבור קליע לא ידוע, 401 עבור מפתח רע, 429, וכל דבר שהולך לא נכון בצד שלנו.

בגלל שטעויות הן חופשיות הן מוגבלות בקצב במקום: אם מפתח אחד מעורר יותר מאשר 200 תגובות דחויות בשעה, זה מקבל HTTP 429 "Too_invialid_requests" עד השעה מתגלגלת. שיחות מוצלחות לא נחשבות לכיוון זה, כך אינטגרציה עובדת לעולם לא תראה את זה □ זה תופס רק לקוח תקוע בלולאה חוזרת.

כאשר מכסת המפתח החודשית משמשת את API מחזירה את HTTP 429 עם שגיאה "qua_exeed"; מפתח לא ידוע או לא פעיל מחזיר 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/ אינדקס.