ממשק JSON של ZmanimPro

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

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

GET /api/shabbat/{city}

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

דוגמת בקשה:

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

דוגמת תשובה:

{
    "city": "Jerusalem",
    "friday": "2026-11-06",
    "candle_lighting": "2026-11-06T16:10:08+02:00",
    "sunset": "2026-11-06T16:50:08+02:00",
    "havdalah": "2026-11-07T18:01:24+02:00",
    "rabbeinu_tam": "2026-11-07T17:58:58+02:00",
    "parsha": "\u05d7\u05d9\u05d9 \u05e9\u05e8\u05d4",
    "hebrew_date": "27 Cheshvan, 5787"
}

שדות:

שדות התגובה של /api/shabbat ותיאורם

שדה	תיאור
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) ואת אודות להערות מתודולוגיה.