דילוג לתוכן המרכזי

API

API למפתחים

זמני היום, זמני שבת, התאריך העברי, הפרשה והמועדים - כ-JSON, בחינם, בלי הרשמה ובלי מפתח. אותם מנועים שמפעילים את האתר עצמו.

התחלה מהירה

curl "https://mevarhim.co.il/wp-json/mevarhim/v1/zmanim?city=jerusalem"

בלי פרמטרים מקבלים את ירושלים והיום. אין צורך בכותרת, במפתח או ב-CORS - Access-Control-Allow-Origin: * פתוח.

נקודות הקצה

GET mevarhim/v1/zmanim

זמני היום

כל זמני היום ביישוב ובתאריך: עלות השחר, הנץ, סוף זמן קריאת שמע ותפילה, חצות, מנחה, שקיעה וצאת הכוכבים.

פרמטרים: city date

נסו עכשיו

GET mevarhim/v1/shabbat

זמני שבת

הדלקת נרות, שקיעה, צאת השבת, רבנו תם, שם הפרשה, והתאריך העברי של השבת שבאותו שבוע.

פרמטרים: city date

נסו עכשיו

GET mevarhim/v1/hebrew-date

תאריך עברי

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

פרמטרים: city date

נסו עכשיו

GET mevarhim/v1/parasha

פרשת השבוע

הפרשה שתיקרא בשבת הקרובה ותאריך אותה שבת, לפי לוח ארץ ישראל או חוץ לארץ.

פרמטרים: city date

נסו עכשיו

GET mevarhim/v1/holidays

חגים ומועדים

המועדים הקרובים בארבעה עשר החודשים הבאים: ימים טובים, חול המועד, צומות וחנוכה.

פרמטרים: city date

נסו עכשיו

GET mevarhim/v1/locations

יישובים

רשימת היישובים והמזהים שלהם. אלה הערכים החוקיים לפרמטר city.

פרמטרים: q

נסו עכשיו

פרמטרים

שםערכיםברירת מחדל
cityמזהה יישוב מ-/locationsjerusalem
dateYYYY-MM-DD, בין 1900 ל-2200היום
qחיפוש יישוב, שני תווים ומעלההערים המרכזיות

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

מבנה התשובה

{
  "api":         { "version", "endpoint", "publisher", "docs", "license" },
  "location":    { "slug", "name", "timezone", "latitude", "longitude", "israel", "url" },
  "date":        { "gregorian", "weekday", "timezone" },
  "methodology": { "profile", "notes" },
  "data":        { ... }
}

כל תשובה אומרת מה חושב, איפה, מתי, ולפי איזו שיטה. methodology.profile מזהה את פרופיל החישוב, וכשהוא משתנה - הערך משתנה איתו.

מכסות ושגיאות

  • 300 בקשות בשעה לכל כתובת רשת. חריגה מחזירה 429.
  • כל תשובה נשמרת במטמון ל-12 שעות ומוגשת עם Cache-Control. בקשה חוזרת אינה מחשבת מחדש.
  • 400 - יישוב לא מוכר או תאריך לא תקין. 503 - מנוע החישוב אינו זמין.
  • לשימוש שחורג מהמכסה - צרו קשר.

שימוש וייחוס

השימוש חופשי, גם מסחרי. אנחנו מבקשים ייחוס גלוי - "זמנים מאתר מברכים", עם קישור - במקום שבו הנתונים מוצגים.

אין קישורים מוזרקים בתשובות. ה-API מחזיר נתונים, לא שיווק. הבקשה לייחוס נמצאת כאן בתיעוד, ולא בתוך ה-JSON.

הזמנים מחושבים אסטרונומית ומיועדים לשימוש מעשי. אנחנו עושים מאמץ לדיוק, ואחריות הפרסום היא על מי שמפרסם.

שיטות החישוב ווידג׳טים מוכנים הזנות יומן