חישוב החזר משכנתא מתוך כלי AI או מערכת חיצונית
הממשק מקבל סכום, ריבית ותקופה, ומחזיר החזר חודשי, סך תשלומים וסך ריבית. אפשר להשוות תרחישים או לחשב כמה מסלולים יחד, בלי לפתוח חשבון ובלי להשאיר פרטי קשר.
החיבור מיועד לכלים שתומכים בקריאות API או בייבוא מפרט OpenAPI. יש להגדיר את החיבור בכלי שבו משתמשים. פרסום המפרט אינו מחבר את האתר אוטומטית ל-ChatGPT, ל-Claude, ל-Gemini או למנוע חיפוש.
מה הממשק מחשב?
החזר שפיצר במסלול בריבית קבועה ולא צמודה, בשקלים, בתשלומים בסוף כל חודש. הריבית שהוזנה נשארת קבועה לכל אורך התרחיש. ניתן לשלוח עד 20 מסלולים, גם בתקופות שונות. הסכום החודשי הכולל הוא ההחזר בתחילת הדרך, והוא יורד כשמסלולים קצרים מסתיימים.
אין כאן תחזית ריבית או מדד, המלצה לתמהיל, אישור אשראי או הצעה מהבנק. החישוב אינו כולל ביטוחים, עמלות, מסים, פירעון מוקדם, גרייס או בלון. לתמהילים הכוללים הצמדה השתמשו במחשבון באתר.
הנוסחה
payment = P × r / (1 − (1 + r)^(-n))
P הוא סכום ההלוואה, r הוא הריבית השנתית באחוזים חלקי 1,200, ו-n הוא מספר החודשים. בריבית אפס, ההחזר הוא הסכום חלקי מספר החודשים. הממשק והמחשבון באתר משתמשים באותה פונקציית חישוב. התוצאות מוצגות באגורות, אך הסכומים הכוללים מחושבים לפני עיגול התשלומים.
איך מתחברים?
- בכלי שתומך בייבוא OpenAPI, טוענים את המפרט ובוחרים גישה ללא אימות. אין מפתח API.
- מגדירים את הפעולה
calculateMortgagePayment. יש להשתמש רק בתרחישים המספריים המבוקשים, ללא פרטי אדם או מסמך. - מציגים את התוצאה יחד עם ההנחות וקישור למחשבון המקור, הכלולים בתשובה.
בקשה: POST https://mashkantes.co.il/api/v1/mortgage-payment
כותרת: Content-Type: application/json. שולחים את הנתונים בגוף הבקשה, ולא בכתובת.
| שדה | משמעות וגבולות |
|---|---|
principal | סכום בשקלים, בין 1 ל-50,000,000. |
annual_rate_percent | ריבית שנתית באחוזים, בין 0 ל-30. למשל 5 פירושו 5%. |
term_months | מספר חודשים שלם, בין 1 ל-360. למשל 300 חודשים הם 25 שנים. |
כל השדות נדרשים ונשלחים כמספרים. שדות נוספים נדחים. גודל גוף הבקשה מוגבל ל-4,096 בתים. מוגדרת ב-Netlify מגבלה של 60 בקשות ב-60 שניות לכל כתובת חיבור ודומיין; אכיפת המכסה עשויה להתעדכן בהשהיה.
דוגמה מחושבת: מיליון שקלים, 5%, 25 שנים
אלה מספרי המחשה בלבד, ולא ריבית שוק או הצעה. ההחזר החודשי הוא 5,845.90 ₪, סך התשלומים 1,753,770.12 ₪, ומתוכם ריבית של 753,770.12 ₪.
בקשה
{
"tracks": [
{
"principal": 1000000,
"annual_rate_percent": 5,
"term_months": 300
}
]
}
תשובה
{
"version": "1.0.0",
"calculation": "fixed_rate_unlinked_annuity",
"currency": "ILS",
"tracks": [
{
"principal": 1000000,
"annual_rate_percent": 5,
"term_months": 300,
"monthly_payment": 5845.9,
"total_payment": 1753770.12,
"total_interest": 753770.12
}
],
"totals": {
"principal": 1000000,
"initial_monthly_payment": 5845.9,
"term_months": 300,
"total_payment": 1753770.12,
"total_interest": 753770.12
},
"assumptions": [
"Fixed nominal annual interest, divided by 12, with monthly payments at the end of each month.",
"No inflation or currency linkage, interest-rate changes, grace periods or balloon payments.",
"Excludes insurance, fees, taxes and early-repayment charges.",
"Totals use unrounded payments; displayed amounts are rounded to two decimal places.",
"A mathematical estimate, not a bank offer, lending approval or personal recommendation."
],
"source": {
"name": "Mashkantes mortgage calculator",
"url": "https://mashkantes.co.il/calculator/",
"documentation": "https://mashkantes.co.il/tools/api/"
}
}
דוגמה לשימוש באמצעות curl
curl https://mashkantes.co.il/api/v1/mortgage-payment \
-H 'Content-Type: application/json' \
--data '{"tracks":[{"principal":1000000,"annual_rate_percent":5,"term_months":300}]}'שגיאות ופרטיות
400: קלט לא תקין או שדות נוספים. 405: שיטת בקשה שגויה. 413: בקשה גדולה מדי. 415: פורמט שאינו JSON. 429: יש להמתין לפני ניסיון נוסף. שגיאת המכסה עשויה להגיע מספק האחסון בפורמט שאינו JSON.
הממשק מבצע חישוב מספרי בלבד. הוא אינו שומר את גוף הבקשה במסד הנתונים של האתר, אינו יוצר ליד ואינו פונה לספק AI. אין לשלוח אליו שמות, טלפונים, תעודות זהות, מספרי חשבון או דוחות. תשתית האחסון מעבדת את הבקשה ועשויה לתעד נתוני תעבורה. מדיניות הפרטיות.
גרסת ממשק: 1.0.0. פורסם ב-.