למפתחים

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

נסו עכשיו

All four work in a terminal, in a browser address bar, or from any page on the internet — access-control-allow-origin is open.

curl https://siliconchabad.com/api/shabbat
curl https://siliconchabad.com/api/zmanim
curl "https://siliconchabad.com/api/zmanim?date=2026-12-25"
curl "https://siliconchabad.com/api/shabbat?weeks=8"

מה מתקבל

This is the real answer from /api/shabbat, generated when you loaded this page — not an example somebody typed out once.

{
  "label": "Shabbat",
  "candleLighting": {
    "iso": "2026-10-09T18:21:00.000-07:00",
    "local": "6:21 PM"
  },
  "havdalah": {
    "iso": "2026-10-10T19:16:00.000-07:00",
    "local": "7:16 PM"
  }
}

Every time is sent twice: iso for a machine, with the offset attached, and local as the clock on the wall in San Jose reads it. That is deliberate — slicing a date off a UTC timestamp gives you tomorrow from five in the afternoon Pacific, and we have shipped that bug four times in our own code.

בתוך דף

const r = await fetch('https://siliconchabad.com/api/shabbat');
const { windows } = await r.json();
document.querySelector('#candles').textContent =
  `Candle lighting ${windows[0].candleLighting.local}`;

כווידג'ט מוכן

Or skip the fetch entirely: /widget/week is a small page with this week’s candle lighting, Havdalah and today’s Hebrew date already drawn, meant to sit inside an <iframe> on your own site or a home-screen widget.

בסקריפט

import urllib.request, json

with urllib.request.urlopen("https://siliconchabad.com/api/shabbat") as r:
    w = json.load(r)["windows"][0]

print(w["label"], "candles", w["candleLighting"]["local"])

איך הזמנים מחושבים

לא לפי ברירות המחדל של ספרייה. כל זווית נקבעת לפי ההגדרות שמפרסם Chabad.org עצמו למיקום הזה:

• עלות השחר ב-16.9° מתחת לאופק — הנתון של Chabad.org, ולא 16.1° הנפוץ.
• הזמן המוקדם ביותר לטלית ותפילין ב-10.2°.
• צאת הכוכבים ב-6°.
• השעה הזמנית נמדדת בין הנץ אמיתי לשקיעה אמיתית — כשהשמש 1.583° מתחת לאופק, כפי שנראה מהרי ארץ ישראל, ולכן היום ארוך יותר מזריחה עד שקיעה כפי שהם מודפסים — ומחולקת בשתים עשרה, לפי שיטת אדמו"ר הזקן.
• הדלקת נרות שמונה עשרה דקות לפני השקיעה.
• צאת השבת ב-8.5°, שהוא זמן מאוחר יותר מצאת הכוכבים. אלו שני מספרים שונים וה-API שולח את שניהם, כי קריאה של אחד במקום השני פירושה לסיים את השבת מוקדם מדי.

האחרון כויל ולא רק תועד: הוא נבדק מול הזמנים ש-Chabad.org עצמו מפרסם לשני תאריכים בסן חוזה, ובדיקה אוטומטית שרצה בכל שינוי מוודאת אותו עד הדקה. כיול קודם מול תאריך אחד בלבד סטה בארבע דקות, והתאריך השני הוא שגילה זאת.

מה הוא לא עושה

• הוא לסן חוזה בלבד. קו רוחב 37.2535, קו אורך −121.8885, הנקודה ש-chabad.org משתמש בה עבור 95118. אם משתמשים בו בלוס אנג'לס הוא טועה בכארבעים דקות, וכל מספר עדיין נראה סביר, ולכן כל תשובה חוזרת ומציינת לאיזה מקום היא מתאימה.
• הוא לא קורא ממסד נתונים, ולכן הוא מהיר, שמור במטמון, ולא יכול להיות מושבת כשהאתר כולו עובד. זה גם אומר שלוח השנה של בית הכנסת שלנו לא נמצא בו.
• זו לא פסיקת הלכה. אלו זמנים מחושבים. כדי לדעת מה לעשות איתם, שאלו אדם — בשביל זה קיימים מספר הטלפון והצ'אט.

שימוש

Freely, including commercially, with no key and no attribution required — though a link back is kind. There is no rate limit; please cache rather than poll. Every response carries cache-control, so a browser or a proxy will hold the answer for you — and the zmanim for a given date never change, which is why an explicit ?date= is cached for a day. If you are going to depend on it for something that matters, tell us so we know it is there.

The code is open: packages/hebrew-calendar in the repository, with the tests that pin every number on this page.

היום בסן חוזה, לעיון: עלות השחר 5:45 AM, זריחה 7:07 AM, חצות היום 12:55 PM, שקיעה 6:45 PM, צאת הכוכבים 7:11 PM. כולם, בכל יום: זמני שבת וחגים.