ממשק JSON של ZmanimPro

מגבלות ותנאי שימוש

• אין צורך במפתח API או בהרשמה. נא לשמור על נפח בקשות סביר — מומלץ לשמור תשובות במטמון למשך שעה לפחות.
• התשובות הן JSON דרך HTTPS. הזמנים מוחזרים בפורמט ISO 8601 עם היסט אזור הזמן של העיר.
• הנתונים מחושבים אלגוריתמית מלוח השנה העברי וממיקומי השמש של NOAA — אותו מנוע של האתר עצמו.

GET /api/shabbat/{city}

מחזיר את זמני השבת הקרובה עבור אחת מהערים הנתמכות. החליפו את {city} במזהה עיר (ראו מדריך הערים).

דוגמת בקשה:

curl https://zmanimpro.com/api/shabbat/jerusalem

דוגמת תשובה:

{
    "city": "Jerusalem",
    "friday": "2026-09-18",
    "candle_lighting": "2026-09-18T18:05:37+03:00",
    "sunset": "2026-09-18T18:45:37+03:00",
    "havdalah": "2026-09-19T19:56:18+03:00",
    "rabbeinu_tam": "2026-09-19T19:52:20+03:00",
    "parsha": "\u05d4\u05d0\u05d6\u05d9\u05e0\u05d5",
    "hebrew_date": "8 Tishrei, 5787"
}

שדות:

שדה	תיאור
city	שם העיר לתצוגה
friday	תאריך יום שישי הקרוב (Y-m-d)
candle_lighting	זמן הדלקת נרות — שקיעה בניכוי ההפרש הנהוג בעיר (ירושלים 40 דקות, מרבית הערים 18)
sunset	שקיעה ביום שישי
havdalah	זמן הבדלה — 72 דקות (צאת הכוכבים 8.5°) לאחר שקיעת שבת
rabbeinu_tam	צאת הכוכבים לדעת רבנו תם — 16.1°
parsha	פרשת השבוע (בתעתיק אשכנזי)
hebrew_date	התאריך העברי של השבת

עבור מזהה עיר לא מוכר תוחזר {"error": "City not found"}.

GET /api/nearest?lat={lat}&lon={lon}

מחזיר את העיר הנתמכת הקרובה ביותר לקואורדינטות שנשלחו (חישוב מרחק haversine על בסיס מאגר הערים). אם העיר הקרובה נמצאת במרחק של יותר מ-500 ק״מ, תוחזר תשובת שגיאה error: "too_far".

דוגמת בקשה:

curl "https://zmanimpro.com/api/nearest?lat=31.78&lon=35.24"

דוגמת תשובה:

{
    "city_slug": "jerusalem",
    "city_name": "Jerusalem",
    "distance_km": 0.7
}

קואורדינטות שגויות או חסרות יחזירו {"error": "Invalid coordinates"}. שלבו עם /api/shabbat/{city} לבניית אינטגרציות מודעות-מיקום.

ייחוס

אם בניתם משהו עם ה-API, נשמח לקישור אל ZmanimPro. ראו כיצד מחושבים הזמנים להסבר על האלגוריתמים (חישובי שמש של NOAA, מודל לוח KosherJava) ואת אודות להערות מתודולוגיה.