יומן השינויים של ה־API

GET /api/v2/data/truck-route accepts a new optional parameter traffic. It sets how traffic is taken into account for the ETA, the rest plan, border arrival times and the times at truck bans:

• forecast (default): recurring congestion at the hour the truck passes each stretch, current jams fading with time to arrival, roadworks and closures on the line, and weather where we have it. The response carries a traffic_forecast block with the delay split by cause.
• live: current traffic only, without recurring congestion.
• off: no traffic adjustment; times are free-flow truck engine times. traffic_forecast then contains only model and mode.

Any other value returns 400 bad_request with the message Invalid traffic: forecast, live or off. Requests without the parameter get the default, forecast.

Truck bans at the forecast arrival time: with forecast or live, truck_bans[].active is now judged at the time the truck is forecast to reach each ban (from depart_at, or now if you send none), before any wait for that ban. A new field truck_bans[].active_at gives the time that was judged, in the ban country's local time. bans_summary, restriction_hits and legal follow the same verdicts, and a ban that the forecast delay newly runs into (for example on a later day or in another country) is listed in truck_bans as well. With traffic=off, active is judged on the free-flow timeline and active_at equals eta_at_ban.

מוצר חדש: Truck Route API (GET /api/v2/data/truck-route, v2 בלבד). קריאה אחת מחזירה מסלול חוקי למשאית ואת כל מה שמנהל תפעול צריך לאורכו. המסלול מחושב על ידי אותו ליבת ניתוב של אפליקציית הניווט למשאיות שלנו, TruckTurn, על נתוני המפה שלנו.

• רכב: height, width, length, weight, axle_load, axles, trailers, emission_class, hazmat (מחלקות ADR) ו-adr_tunnel (B–E). איסורי נסיעה למשאיות ואזורי הגבלה נבדקים על הקו המוחזר.
• לאורך המסלול: תחנות דלק עם מחירים עדכניים, חניות למשאיות ותחנות שקילה, כל אחת עם km_from_start ועקיפה.
• תוכנית מנוחה לנהג לפי תקנה 561/2006 של האיחוד האירופי: הפסקות (כולל הפסקה מפוצלת 15+30), מנוחה יומית ושבועית (כולל מקוצרת), צוות של נהג אחד או שני נהגים (crew=2), החל ממצבו הנוכחי של הנהג אם מועבר. כל עצירה ממוקמת בחניה אמיתית לאורך המסלול. זהו כלי תכנון ולא רישום טכוגרף.
• ETA הכולל מנוחות, איסורי נסיעה למשאיות והמתנה בגבולות. התכנון לפי depart_at או arrive_at.
• הערכות עלות אגרות לפי מדינה (EUR, לפי מספר סרנים ומחלקת פליטה), כאשר מדינות ללא תעריף מפורטות ב-tolls.coverage_note. וכן avoid (כבישי אגרה, מעבורות, כבישים מהירים, גבולות, מנהרות, דרכים לא סלולות, אזורי פליטה נמוכה), עד 2 חלופות, פילוח לפי מדינה, ו-geometry בפורמט polyline5, polyline6 או GeoJSON.

מכסה: מכסה נפרדת לקריאות truck-route: 10 קריאות ביום לכל חשבון, יותר בתוכניות בתשלום, ותוסף קריאות truck-route נוספות. ב-sandbox ניתן להריץ 10 מסלולי משאית ביום, לראות את התוצאה על המפה עם תוכנית המסלול המלאה, ולייצא אותה כ-GPX, KML, GeoJSON, CSV, לוח שנה (.ics) או ITN. ראו את דף המוצר ואת התיעוד.

לפי תנאי ה-API, Market הוא המדינה שאת נתוניה אתם משתמשים, והמפתח שלכם מכסה את המדינות המאושרות עבור החשבון שלכם. עד כה, מוצרים מבוססי קואורדינטות (lat/lon — למשל Nearby Shops, Truck Parkings, Fuel Stations) השיבו עבור כל נקודה באירופה. החל מ-13 באוקטובר 2026, הדבר נבדק בעת טיפול בבקשה שלכם:

• בקשה שה-lat/lon שלה נמצאים במדינה שאינה מאושרת עבור החשבון שלכם מחזירה 403 עם error.code market_not_allowed. ההודעה מציינת את המדינה ואת רשימת המדינות המאושרות שלכם.
• כאשר הרדיוס חוצה גבול, תוצאות שה-country_code שלהן מחוץ למדינות המאושרות שלכם מוסרות. התגובה כוללת אז markets_filtered (כמה הוסרו) ו-markets_notice, ו-total_found סופר רק את מה שקיבלתם.

זה חל על חשבונות שהמדינות שלהם נבדקו (סטטוס approved או partial). דבר לא משתנה בבקשה — אין פרמטר חדש, אין גרסה חדשה. אם האפליקציה שלכם זקוקה למדינה נוספת, הוסיפו אותה בפורטל המפתחים לפני 13 באוקטובר. market_not_allowed מופיע יחד עם שאר קודי השגיאה בעמוד ההפניה.

חשבונות מפתחים המקושרים לחשבון Nakordoni Partners עם אותה כתובת אימייל יכולים כעת לשלוח חדשות ולנהל את צי ה-NakBus שלהם (NakDriver / NakManager) דרך partners.nakordoni.eu, עם תפקידי צוות (Owner, Manager, Viewer) והתחברות בלחיצה אחת בין שתי הפלטפורמות. עמודי פורטל המפתחים, מפתחות ה-API, נקודות הקצה של הצי והאפליקציות נותרים ללא שינוי.

ב-Fuel Prices, השדה updated_at והדגל age_hours/stale של התשובה עצמה פעלו לפי שעונים שונים: updated_at מתקדם רק כשמחיר באמת משתנה, אך התיישנות חושבה כאילו הוא מתקדם בכל אישור. 46.7% מהאינדקס עם מחירים הציגו age_hours ≤48 ו-stale:false בעוד ש-updated_at היה למעשה ישן מ-48 שעות, ו-12,620 תחנות היו ישנות משבוע. כעת כל מחיר נושא גם confirmed_at — הפעם האחרונה שבה אישרנו את המחיר, מעוגל כלפי מטה לשעה, ולעולם לא מוקדם מ-updated_at — וה-age_hours/stale מחושבים ממנו. משמעות updated_at לא השתנתה: השתמשו בו כשרוצים לדעת מתי המחיר השתנה לאחרונה, והשתמשו ב-confirmed_at כשרוצים לדעת עד כמה הוא עדכני כרגע. לא קיים בחוזה v1 הקפוא.

שני באגי שפה, שניהם שקטים: שליחת קוד הדרגה הקנוני עם lang=pl (או כל אחת מ-24 שפות האתר האחרות) החזירה את fuel_type_local באנגלית בכל מקרה — רק 10 שפות נבדקו מול טבלת התוויות, ולכן כל שפה מחוץ לרשימה נפלה לאוצר המילים ברירת המחדל של הממשק במקום לשפה שביקשתם. בנפרד, lang=tr (או כמה קודים תקפים אחרים) החזיר רשימות תחנות באוקראינית, כי ברירת מחדל פנימית uk הופעלה בכל פעם שהשפה המבוקשת לא הייתה באותה רשימה של 10 שפות. שניהם תוקנו: השפה שאתם שולחים היא עכשיו השפה שאתם מקבלים, בכל 25 השפות.

בנוסף: השדה brand ב-Nearby Fuel Stations כבר לא מחזיר את ערך הסימון הגולמי של הקליטה OTHER עבור כ-330 תחנות שבהן המותג לא ידוע לנו — הוא null, בהתאם לכל שדה לא ידוע אחר בתשובה.

Border AI Assistant (/api/v1/data/assistant) החזיר 503 internal_error — “Assistant temporarily unavailable” — כאשר אותו מפתח שאל את אותה שאלה פעמיים בתוך חמש דקות. בפועל שום דבר לא היה בלתי זמין: ברוב המקרים האלה התשובה כבר חושבה והייתה מוכנה להחזרה. מעתה היא מוחזרת כרגיל, עם ok: true ו-HTTP 200.

כאשר הבקשה החוזרת מגיעה בזמן שהתשובה הראשונה עדיין נכתבת, הקריאה מחזירה כעת 429 עם error.code בערך duplicate_request במקום 503, כך שמדיניות ניסיון חוזר יכולה להבחין בין “שאל שוב בעוד רגע” לבין תקלה אמיתית. שני המקרים גם נספרו כשגיאות שרת בשיעור השגיאות של החשבון שלך; הם אינם נספרים עוד. דבר בבקשה עצמה אינו משתנה — לא פרמטר ולא גרסה. duplicate_request מופיע ברשימת קודי השגיאה במסמכי העזר.

Truck Parking (/api/v2/data/truck-parkings) החזיר רשומות שבהן name היה null ו-address היה ריק — ליד Bensheim, 20 מתוך 50. אלה מקומות שאנו מחזיקים כקואורדינטה בלבד: אין מה להציג ואין מה להתאים למאגר ה-POI שלך. הם אינם חלק מהמוצר הזה עוד: כעת מוחזרים רק מקומות בעלי שם, כרגע יותר מ-22,000 ברחבי אירופה. אם סיננת בעצמך רשומות ללא שם, הקוד הזה מיותר כעת אך אינו מזיק. התשובות מתקצרות עבור אותם radius ו-limit, וכל רשומה שחוזרת ניתנת לשימוש.

בנפרד, בכ-10,000 חניונים הופיע צמד קואורדינטות גולמי בשדה name, למשל 51.927301,10.14112, בעוד השם האמיתי היה בשדה address. כעת הם נושאים את השם הזה — Ionity, Seesen, Rest Area A5 E35 Kaelberpfad, Bensheim — בכל מקום שבו הם מופיעים, כולל /api/v1/data/pois. ה-id של כל מקום לא השתנה, ולכן מיפוי ששמור במטמון נשאר תקף; רק name שונה.

snapshot.updated_at בנקודות הקצה /api/v1/data/queue ו-/api/v1/data/multi הוא שעה מקומית באזור הזמן של המעבר עצמו (למשל Europe/Istanbul, Europe/Sofia, Europe/Budapest, Europe/Warsaw, Europe/Kyiv), ועד כה שום דבר בתשובה לא ציין באיזה אזור מדובר, כך שהקורא לא יכול היה לתרגם אותה לרגע מדויק. snapshot מקבל שדה נוסף timezone (שם IANA) לצד updated_at. ללא פרמטר, ללא גרסה, ללא שינוי בשדות אחרים.

עד היום כל נקודת קצה של דלק תיארה את הכיסוי שלה מרשימה שנכתבה ביד: AT, DE, DK, ES, FR, HR, IT, LU, PL, PT, SI, ובה פולין צומצמה לאזור Trójmiasto. שתי הקביעות התיישנו מזמן. הכיסוי נמדד כעת מהאינדקס החי של התחנות ומחושב מחדש כל שש שעות: היום יש תחנות עם מחירים ב39 מדינות, וביניהן פולין בכל רחבי המדינה ולא בשלוש ערים. בבקשה עצמה לא משתנה דבר: לא פרמטר ולא גרסה.

Nearby Fuel Stations ו-Cheapest Fuel: כשחיפוש חוזר ריק, בלוק coverage נושא כעת ערכים מדודים station_countries, station_counts, sparse_coverage ו-measured_at, מצומצמים לסוג הדלק שביקשתם ולא לדלק בכלל. מדינה נכנסת ל-sparse_coverage כשיש לנו בה 25 תחנות עם מחיר או פחות — זו ספירה ולא הערכה.

נוספה הערה חדשה לסוג שאנחנו מזהים אך איש אינו מתמחר אותו במקום שבו שאלתם. עד כה coverage.fuel_type_note הופיעה רק כששם המשאבה עצמו לא היה מוכר לנו. כעת היא מופיעה גם כששם מזוהה נכון ופשוט אין עבורו מחיר באותה מדינה; היא נוקבת במדינות שבהן הסוג הזה מתומחר ובסוגים שאנחנו מתמחרים סביבכם. השם הצ׳כי Natural 100 הוא הדוגמה הנקייה: הוא מזוהה, אך אף מקור אינו נותן לו מחיר בצ׳כיה. תשובה ריקה כבר לא נראית כמו בקשה שבורה.

Fuel Grades (/api/v2/data/fuel-grades) מקבל priced_countries ו-priced_station_counts לכל סוג, וכן priced_here כששולחים ?country=. שתי הרשימות אומרות דברים שונים: מדינה תחת countries היא מדינה שבה אנחנו מקבלים את שם המשאבה הזה, ואילו priced_countries מציין היכן מקור אכן מתמחר אותו, ולכן priced_here בערך 0 הוא תשובה אמיתית ולא חור בתשובה. התשובה נושאת גם coverage_measured_at ו-coverage_note, ו-Cache-Control יורד מ-24 שעות ל-6 כדי להתאים לתדירות החישוב מחדש.

מזוהים גם עוד שמות מקומיים של משאבות, ביניהם Klimadiesel 90 (HVO100) ו-HVO Diesel, Erdgas ו-Metano, Autogas ו-Autogaz, DEF עבור AdBlue, וכן שורה של שמות מסחריים של סולר ובנזין פרימיום. סדר הזיהוי לא השתנה וההתאמה נשארת מדויקת, ולכן אף שם שעבד קודם אינו אומר היום משהו אחר, ושם חדש יכול לכל היותר להפוך תשובה ריקה לתשובה עם מחירים. במקביל תוקנו תיעוד העזר ותיאורי נקודות הקצה בכל 25 שפות האתר.

Cheapest Fuel (/api/v2/data/fuel-cheapest) החזיר את התחנות הקרובות ביותר לפי סדר מרחק במקום את הזולות ביותר. מכיוון שהדירוג הופעל לפני שהתוצאה קוצצה לפי ה-limit שלכם, התחנות הזולות ביותר בתוך הרדיוס שלכם יכלו להיעדר לחלוטין מהתשובה. הדירוג תקין כעת: הזולה ביותר קודם עבור סוג הדלק שביקשתם, במקרה של תיקו מנצחת התחנה הקרובה יותר, ותחנה ללא מחיר עבור אותו סוג דלק מדורגת אחרונה. שום דבר בבקשה אינו משתנה — לא פרמטר, לא גרסה.

תגובות הדלק של v2 מתועדות גם הן כפי שהן נשלחות בפועל: התחנות מגיעות תחת data.stations[], רשומה אחת לכל תחנה פיזית, כאשר כל סוג דלק מקונן בתוך האובייקט prices (price, currency, local_name, updated_at, age_hours, stale), וכן station_ref, grades, total_found ו-notices. תיעוד העזר עבור Nearby Fuel Stations ו-Cheapest Fuel עדיין תיאר את רשימת השורות השטוחה הישנה data.data[].

בעמוד החיוב (לשונית חודשית) זמינות שתי תוספות מעל כל תוכנית, בלי לשנות אותה: קריאות תחזית נוספות — +100 קריאות תחזית וסטטיסטיקה ביום לכל בלוק, €2 לחודש לכל בלוק, עד 10 בלוקים; וכן מדינות נוספות — +1 מדינה שניתן להצהיר עליה לכל יחידה, €2 לחודש לכל אחת. שינוי הכמות מציג הצעת מחיר יחסית מדויקת לפני שנגבה תשלום כלשהו.

החל מ-10 בנובמבר 2026 כל תוכנית כוללת מספר קבוע של מדינות מוצהרות: Explorer ו-Student 4, Starter 10, Pro ומעלה ללא הגבלה. ממועד זה לא ניתן יהיה לשמור הצהרה ארוכה יותר מהתוכנית בתוספת המדינות הנוספות שנרכשו; לשונית החשבון מציגה כבר עכשיו את המכסה שלך, וחשבונות שכבר חורגים ממנה רואים הצעה בלוח הבקרה. לפני 10 בנובמבר דבר אינו משתנה.

סביבת הבדיקות של ה-API מסמנת כעת כל נקודת קצה ברשימה עם מחלקת המכסה שלה (כבד / סטנדרטי), מציגה את עלות המכסה לגרסה שנבחרה עוד לפני שמריצים משהו, ואחרי קריאה מציגה כמה הייתה עולה אותה קריאה מהמכסה החיה שלך — כולל הנוסחה ceil(N ppids × M sub-products / 2) המשמשת לקריאות בתבנית /multi.

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

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

למה הכלל הזה קיים. ב-24 באוגוסט 2026 הכרזנו כי truck-bans v1 יוצא משימוש ב-8 בספטמבר 2026. שני חשבונות נרשמו ימים אחדים אחרי ההכרזה, בנו את האינטגרציה שלהם על v1 והגיעו עד כדי שעות ספורות מקבלת 410 בלי שאף אחד מהמיילים שלנו הגיע אליהם: גם ההכרזה וגם משלוח ההתראות קדמו להרשמה שלהם. שום דבר ב-API לא מנע מהם לאמץ גרסה שכבר אמרנו שהיא עומדת להיעלם. זו הייתה התקלה שלנו, וזה התיקון — אי אפשר לאמץ מחדש משהו שכבר נקבע להסרה.

איך זה נראה. קריאה כזו נדחית עם 410 Gone וקוד שגיאה version_closed_to_new_accounts. ההודעה מציינת את תאריך ההוצאה משימוש, את תאריך ההכרזה ואת הגרסה שיש להשתמש בה במקום. זהו במכוון קוד שונה מ-version_sunset, שאותו מקבל כל חשבון לאחר שתאריך ההוצאה משימוש עצמו חלף — כך התמיכה יכולה להבחין בין «הגעת מאוחר מדי כדי להתחיל» לבין «זה הוסר עבור כולם» בלי לקרוא לוג.

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

בתוקף כעת עבור truck-bans v1 (הוכרז ב-24 באוגוסט 2026, יוצא משימוש ב-8 בספטמבר 2026), ואוטומטית עבור כל הוצאה משימוש שנכריז עליה מכאן ואילך. לא נדרש ממך דבר חדש: כל תגובה בגרסה שיוצאת משימוש כוללת כבר את הכותרות Deprecation, Sunset ו-Link: rel="successor-version", כך שאינטגרציה חדשה יכולה לראות הוצאה משימוש מתקרבת בלי לקרוא את הדף הזה.

המשך לשינוי v4 של אתמול (פנייה למפתחים #105). רשימות destination מופרדות בפסיקים ב-v1 וב-v2 ממשיכות לעבוד, אך כעת הן כפופות לאותו לוח זמנים כמו destination=all: שתיהן נעצרות ב-2026-10-06 (עד אז כותרות Deprecation/Sunset, ולאחר מכן 400 destination_list_removed, המפנה אל /api/v4/ כתחליף). בדיקת המגבלה הקיימת של 10 פריטים ברשימות עם פסיקים אינה משתנה עד לאותו מועד.

v4 נשאר עם יעד אחד לכל קריאה — זה לא השתנה היום. מה שהשתנה הוא רק אופן ההסבר על v1/v2: שגיאת 400 של destination=all כבר אינה מציעה רשימה עם פסיקים כמסלול מעבר (היא הייתה נסגרת באותו תאריך), אלא מפנה ישירות ל-v4.

תיקון בתיעוד: הדוגמה של v4 באתר זה הופיעה קודם לכן כ-/api/v4/data/border/1/2,3,4/9 — רשימה עם פסיקים, ש-v4 דוחה. כעת היא /api/v4/data/border/1/2/9. מי שהעתיק את הדוגמה הישנה היה מקבל 400 כבר בקריאה הראשונה; אנו מתנצלים.

מפתח מתורגם חדש product_border_v4_p_destination יוצא בכל 25 שפות האתר ומנסח במפורש את כלל היעד היחיד ב-v4, במקום ליפול לניסוח של v1/v2.

/api/v4/data/border/{origin}/{destination}/{crossing_type} עלה לאוויר היום. שלושה דברים משתנים לעומת v2, וביחד הם הסיבה שמדובר בגרסה חדשה ולא בעדכון.

1. אין יותר destination=all. הנתונים שלנו מורשים לפי מדינה (Developer API Terms, סעיף 7), ותו כללי שמתרחב ל"כל מדינה שכנה שיש לנו עליה נתונים" מחזיר מדינות שהחשבון שלכם אולי אינו מאושר עבורן — ובבקשה עצמה אין שום דבר שמראה זאת. ב-v4 אתם נוקבים בשם המדינה.

2. מדינת יעד אחת בכל קריאה. /api/v4/data/border/1/2/9 מבקש גבול אחד. רשימות מופרדות בפסיקים אינן מתקבלות: שלחו את 1/2/9, 1/3/9 ו-1/4/9 כקריאות נפרדות. רשימה עם פסיקים או all מקבלים בתשובה 400 ובה שמות הקריאות המדויקות שיש לשלוח, כך ששום דבר לא נכשל בשקט.

3. קוד משאית אחד. ב-v1 וב-v2 הובלת המטענים פוצלה ל-8 (Freight Transport) ול-9 (Freight Transport עד 7.5 טון). הפיצול הזה אמיתי במעבר עצמו, אבל אף מפתח לא יכול לפעול לפיו: בקשה ל-9 מ-v2 בגבול UA-PL החזירה 21 מתוך 70 מעברי המשאיות, ושום דבר לא ציין זאת. v4 עונה ל-9 עם כל נתיבי המשאיות, ומקבל את 8 כשם נרדף ל-9. כל שורה נושאת את crossing_type שלה, כך שתשובה משולבת נשארת ניתנת לבדיקה.

ב-v1 וב-v2, destination=all ימשיך לעבוד עד 2026-10-06 ויישא כותרות Deprecation / Sunset עד אז. מאותו תאריך הגרסאות האלה יחזירו 400 גם עבור all — שאר v1 ו-v2 נשאר ללא שינוי וזמין. אותו תאריך חל גם על שאר קיצורי כל-המדינות: travel-matrix בלי ?dest=, bus-carriers עם ?ppid=all, ו-fuel-grades בלי ?country=.

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

כל השאר ב-v4 זהה ל-v2: סדר נתיב לפי כיוון, direction{from,to}, stale, ו-?max_age_min=.

המזהים המספריים ב-/border/{origin}/{destination}/{crossing_type} מעולם לא פורסמו כטבלה, ולכן מפתחים שחזרו אותם מאזורי זמן ומכתובות לדוגמה. עכשיו הם בתיעוד תחת קודי מדינה וסוג רכב, ומוצגים מאותן טבלאות שמולן ה-API מאמת — מזהי מדינה יחד עם הגבולות שכל אחד מהם מתרחב אליהם, וכל crossing_type עם התווית שה-API מחזיר.

בזמן הפרסום גילינו שה-sandbox והמטא-נתונים של נקודות הקצה מתארים את 8 כ-"truck<7.5t" ואת 9 כ-"truck". זה הפוך: ה-API מתייג את 8 כ-Freight Transport ואת 9 כ-Freight Transport עד 7.5 טון, וכך היה תמיד. אם בחרתם קוד משאית מתוך רמז הפרמטר, סיננתם בדיוק את הנתיב ההפוך לזה שהתכוונתם אליו. תוקן בכל המקומות, ו-v3 מסיר את הבחירה לגמרי.

תנאי ה-API v1.1 מחליפים את v1.0 עוד לפני שנכנס לתוקף, וחלים מ-2026-10-06. אנא אשרו אותם בלוח הבקרה שלכם.

סעיף 7 אומר עכשיו מהו Market: המדינה שבנתוניה אתם משתמשים — המדינה שבה נמצאים המעבר או הגבול שאתם מבקשים — ולא המדינה שבה גרים המשתמשים שלכם. בלוח הבקרה שלנו נכתבו שני הדברים במקומות שונים; האכיפה תמיד התכוונה לראשון.

שני שינויים לטובתכם. מדינות שכבר אושרו לחשבון שלכם נשארות זמינות בזמן ששינוי מאוחר יותר נמצא בבדיקה (הוספת מדינה כבר לא משעה את אלה שכבר יש לכם). ואם לא השבנו להצהרת market בתוך 5 ימי עסקים, מגבלות התוכנית המלאות שלכם חלות עד שנשיב.

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

שלושה מוצרים כוללים עכשיו שדה data_quality נוסף (high או low) שמסמן אם קריאה היא תצפית אמיתית או הערכת מודל שאין לה מקור ספירה חי במעבר הזה: queue (ברמת snapshot העליונה ובכל שורה היסטורית ב-data[] — לא בשורות התחזית), update-info (במעטפת), ו-multi (בשני תת-האובייקטים queue ו-update_info לכל מעבר). זה אינו אות חדש — הדגל עצמו כבר היה קיים פנימית — אבל הוא מעולם לא נחשף, ולכן מעבר שכולו ממודל נראה זהה למעבר שנמדד ישירות. is_realtime לא שונה בכוונה: הוא עדיין מחזיר true לשורות ממודלות, ושינוי המשמעות הזאת הוא שינוי שובר ברמת v2 שאיננו עושים כאן.

גם מהגרסה הזאת: המוצר queue-advanced כבר לא מפיץ נתוני מזג אוויר גולמיים ממקור חיצוני. weather_main, temperature ו-wind_speed מוחלפים ב-condition_code נגזר (סולם סיכון 0–5, null כשאין נתוני מזג אוויר), condition ו-severity.

החל מ-2026-08-30 בקשת /api/v1/data/multi אחת נענית עבור 5 מעברי גבול לכל היותר. קריאה שמונה יותר מזהי PPID אינה נדחית: היא עדיין מחזירה 200, אך נענים רק 5 המזהים הראשונים ב-?ppids=. שאר המזהים נותרים ללא מענה, מוחזרים ב-meta.ppid_cap.ignored ואינם נגרעים מהמכסה שלך — החיוב על הקריאה הוא לפי מה שהיא מחזירה בפועל.

כל עוד קריאה חורגת מהמגבלה, התשובה כוללת כותרת X-Devapi-Warning: multi_ppid_cap ובלוק meta.ppid_cap עם השדות cap, enforced_from, enforced, ppids_asked, ppids_answered ו-ignored[]. עד 2026-08-30 השדות האלה מופיעים עם enforced: false ועם מערך התוצאות המלא, כך שתוכל לראות את השינוי המתקרב ביומני הרישום שלך.

ההנחה של מחצית מהמכסה נותרת ללא שינוי. חלק את מעברי הגבול שלך לקבוצות של 5 ושלח קריאה אחת לכל קבוצה במחזור הרענון הרגיל שלך; לתשאול תכוף של אורך התור וטריות הנתונים בלבד, update-info נשאר המוצר הזול יותר במחלקה הסטנדרטית.

איסור החום המחושב לאוקראינה — מוחזר עם include_ua_heat, ובבקשות country=UA באופן אוטומטי — עונה כעת לטווח התאריכים שביקשת. בעבר הוא החזיר את שבעת הימים הקרובים בלי קשר ל-date_from ול-date_to, ולכן טווח בדצמבר החזיר בשקט את השורות של השבוע הנוכחי. האיסור מחושב מתחזית מזג האוויר ואינו נקרא מלוח האיסורים, ולכן יש לו שני גבולות שאין ללוח: הוא אינו מביט אחורה ומסתיים במקום שבו התחזית מסתיימת. הטווח שלך נחתך כעת עם מה שהתחזית באמת מכסה, והשדה החדש ua_heat_ban.forecast_horizon מציין את התאריך האחרון שאליו היא מגיעה. טווח מעבר לאופק הזה אינו מחזיר שורות ומסביר מדוע בשדה summary — וזה אינו זהה ל„אין איסור“. תשובות v1 לא השתנו.

מבנה התשובה לא היה מתועד בשום מקום — הדרך היחידה לדעת מה מוצר מחזיר הייתה לקרוא לו. עכשיו בעמוד של כל מוצר, מתחת לטבלת הפרמטרים, מופיעה טבלה שדות התשובה עם תיאור קצר של כל שדה; שדות של פריטי רשימה מוצגים כך: items[].name, ושדות ברמת המעטפת (usage, meta, snapshot, resolved_location) מוצגים ללא קידומת. 40 מתוך 42 מוצרים מתועדים: השניים שטרם הושקו (weather, road-quality) נשארים בכוונה בלי תיאור. אותה טבלה מתפרסמת גם במראה הציבורית של התיעוד שלנו ב-GitHub.

כל מוצרי הדלק מקבלים מעכשיו את השם המקומי של סוג הדלק, ולא רק את הכתיב הפנימי שלנו: ON בפולין, Nafta בצ׳כיה, Gázolaj בהונגריה, Motorină ברומניה, ДП באוקראינה, Motorin בטורקיה, Gasóleo בפורטוגל ובספרד. השם מפוענח קודם כול לפי המדינה — „95” הוא E10 במשאבה דנית ו-E5 במשאבה פולנית — לכן שלחו country יחד עם השם המקומי, או קואורדינטות שלפיהן אפשר לאתר את הנקודה. בתשובה חוזרים fuel_type (הקנוני), fuel_type_requested (כפי שכתבתם) ו- fuel_type_local. שם שאיננו מצליחים לאתר לעולם אינו מוחלף בסוג דלק ברירת מחדל: התשובה חוזרת ריקה ואומרת זאת במפורש.

הטבלה המלאה היא כעת מוצר בפני עצמו — GET /api/v2/data/fuel-grades[?country=PL][&fuel_type=ON] — סוגי הדלק הקנוניים שלנו והשמות המקומיים שלהם ב-41 מדינות באירופה, כולל שווקים שאיננו מפרסמים להם מחירים. נוסף על כך, שכבות המדינה והאזור של fuel ו- fuel-local קיבלו אובייקט grades הממפה כל מפתח מחיר לסוג הדלק ולשם שבו משתמשים במשאבה.

המוצר truck-bans עונה מעתה עבור תאריך מסוים או טווח תאריכים בכתובת /api/v2/data/truck-bans. עד כה הוא החזיר תמיד את שבעת הימים הקרובים והתעלם מכל תאריך שנשלח אליו, ולכן בניית לוח שנה חייבה בקשה נפרדת לכל יום — ובתוכנית של שתי בקשות בשנייה רובן נדחות עם 429 qps_exceeded.

השתמשו ב-?date=YYYY-MM-DD ליום בודד, או ב-?date_from= וב-?date_to= לטווח. שני הקצוות כלולים וניתן להשמיט כל אחד מהם: ההתחלה היא כברירת מחדל היום, והסוף הוא ההתחלה בתוספת 7 ימים. חלון יכול לכסות 92 ימים לכל היותר — חלון ארוך יותר נדחה עם 400 date_range_too_long במקום להיחתך בשקט. זהו לוח שנה צופה פני עתיד: חלון יכול להתחיל 7 ימים אחורה לכל היותר, ותאריכים מוקדמים יותר נדחים במקום להיות מוגשים — הכיסוי משתרע קדימה עד 31 בדצמבר 2028 ב-23 מדינות.

כל תשובה כוללת מעתה אובייקט window המציין במדויק את הטווח המכוסה. זהו שדה נוסף והוא נשלח גם ב-v1, שם v1 שומר על חלון שבעת הימים הקבוע שלו ללא שינוי. שימו לב: include_ua_heat מכסה תמיד את שבעת הימים הקרובים, יהיה החלון שתבקשו אשר יהיה — הוא מחושב מתחזית מזג אוויר ולא מלוח האיסורים. נזכיר כי גרסת v1 של מוצר זה תיסגר ב-8 בספטמבר 2026.

שני שיפורים קשורים בכל ה-API: כל פרמטר שהמוצר אינו מקבל מופיע מעתה ברשימת ignored_params בתשובה במקום להיזרק בשקט, ושגיאות אימות משירות הנתונים מגיעות אליכם כפי שנכתבו, עם הקוד הקריא-למכונה בשדה error.reason.

שלושה תיקוני איכות תגובה מתוך ביקורת על השער (כרטיס #43).

הכותרת X-API-Key מתקבלת מעכשיו לצד Authorization: Bearer ו-?key=. אם לקוח ה-HTTP שלכם שולח מפתחות בכותרת בשם X-API-Key, זה עובד עכשיו — בעבר היא נותרה ללא התייחסות והקריאה נדחתה כ-missing_api_key. Authorization: Bearer נשארת הצורה המתועדת והמומלצת.

הודעת השגיאה על מפתח חסר מציינת עכשיו את כל שלוש דרכי האימות (כותרת Bearer, כותרת X-API-Key, או ?key=) במקום לקשר רק לעמוד ההרשמה.

ספריית checkpoints כוללת מעכשיו has_day_stats בכל שורה — שדה בוליאני נוסף שמציין אם ל-API של Best Time to Cross (day-stats) יש נתונים עבור אותו מעבר. Day-stats קיים רק עבור חלק מהמעברים המנוטרים; בדקו את הדגל הזה לפני שליחת בקשות כדי להימנע מ-404 צפויים. השדות הקיימים לא השתנו.

תוקן גם בתיעוד: המוצר road-conditions תמיד כיבד את הפרמטר lang לתרגום תוויות — הוא פשוט לא הופיע ברשימה.

שני תיקונים וגרסה חדשה אחת למוצר truck-bans.

מדינות מופרדות בפסיק עובדות מעכשיו. ?country= מקבל רשימה של עד 3 קודי ISO-2, למשל ?country=DE,RO. רשימה ארוכה יותר נדחית עם 400 too_many_countries במקום להיחתך ללא התראה — זהו לוח איסורים לפי מדינה, לא הזנה המונית. בעבר זה לא עבד: המפריד הוסר, ולכן DE,RO נקרא כאסימון יחיד DERO, לא התאים לדבר, והחזיר success: true עם total_bans: 0 — “אין איסורים” נחרץ עבור שתי מדינות שהיו להן יחד 22. אם עקפתם זאת בשליחת בקשה נפרדת לכל מדינה, עכשיו בקשה אחת מכסה את כולן ועולה קריאה אחת במקום כמה.

התגובות מדווחות מעכשיו על שלמותן. שלושה שדות נוספים — returned, total_available ו-truncated — מציינים אם התשובה הוגבלה. במיוחד קריאה ללא היקף מחזירה פרוסה מוגבלת, ועד עכשיו שום דבר בגוף התגובה לא ציין זאת. total_bans שומר על משמעותו הקיימת (שורות בתגובה הזו), ולכן שום דבר שאתם כבר מנתחים לא משתנה.

v2 מוגבל בהיקף לפי מדינה. בכתובת /api/v2/data/truck-bans הפרמטר ?country= הוא חובה, ובקשה ללא היקף נדחית עם 400 scope_required — המוצר הזה הוא לוח איסורים לפי מדינה, לא הזנה המונית. v1 לא משתנה היום — הוא עדיין מקבל קריאה ללא היקף ועדיין מחזיר את אותן 50 שורות מוגבלות כמו תמיד, ולכן שום דבר שרץ אצלכם לא נשבר כרגע. גרסת v1 של המוצר הזה יוצאת משימוש ב-8 בספטמבר 2026. היא פועלת כרגיל עד 7 בספטמבר; מ-8 בספטמבר בקשת v1 נדחית עם 410 Gone ועם הודעה המפנה ל-v2. עד אז כל תגובת v1 נושאת Deprecation: true, כותרת Sunset עם התאריך הזה, וכותרת Link המציינת את הגרסה היורשת, כך שספריית לקוח יכולה להציג את המועד בלי שאיש יקרא את העמוד הזה. למעבר: שנו את מקטע הגרסה ל-/api/v2/data/truck-bans והעבירו ?country=.

תיקון תיעוד אחד: הפרמטר date הוסר. הוא הופיע ברשימה זמן רב אך מעולם לא נקרא על ידי השירות, ולכן כל בקשה ששלחה אותו קיבלה ללא התראה את חלון ברירת המחדל של 7 ימים במקום היום שביקשה. כדי לבחור יום, סננו את המערך upcoming_bans לפי שדה ה-date שלו. כמו כן, קוד ISO-3 כגון DEU כבר לא מתורגם לשם מדינה בסיכום, שם הוא יצר את ההודעה המטעה “No truck ban data for: Germany.”

המוצר truck-bans מחזיר כעת הגבלות תנועה ארציות עבור חמש מדינות נוספות: בלגיה (BE), בלארוס (BY), מונטנגרו (ME), צפון מקדוניה (MK) ושוודיה (SE). הכיסוי הקיים עבור בולגריה, יוון ופורטוגל הורחב ורוענן — ההגבלות היווניות מגיעות כעת עד ספטמבר 2027, ופורטוגל מאוכלסת שוב בנתונים.

מבנה התשובה לא השתנה. השורות החדשות נושאות את אותם מפתחות ככל איסור אחר: date, time_from, time_until, restriction_type, restriction_details, min_weight_tons ו-details_url. כאשר הגבלה חלה רק בתנאי מסוים — למשל, איסורי הקיץ בבלארוס חלים מעל 25 °C — התנאי מצוין בשדה restriction_details, ולכן קראו שדה זה לפני שאתם מזהירים נהג. הערך min_weight_tons הוא null כאשר הכלל מתייחס לסוג הובלה (חומרים מסוכנים) ולא למשקל.

המוצרים fuel-stations ו-fuel-cheapest מחזירים כעת מחירים ברמת התחנה בפולין. הכיסוי חלקי — אזור שלוש הערים (גדנסק, גדיניה, סופוט) — ולכן פולין מדווחת במערך חדש ונוסף coverage.sparse_coverage לצד הרשימה הקיימת coverage.station_countries. למדינה המופיעה ב-sparse_coverage יש נתוני תחנות עבור חלק משטחה בלבד; שאילתה במקום אחר באותה מדינה מחזירה רשימה ריקה יחד עם הערת הכיסוי, בדיוק כמו קודם. המחירים הפולניים נקובים ב-PLN.

גם שגיאת השאילתה ההמונית ברורה יותר: כאשר lat חסר, ההודעה scope_required מפנה כעת למוצר fuel (?country=XX) לקבלת מחירים ממוצעים ארציים.

GET /api/v2/data/fuel-local?lat=&lon= מחשב כעת את המחיר בשלוש רמות במקום שתיים: station, אחר כך region, ואז country. הרמה האמצעית החדשה קיימת עבור אוקראינה, שבה אין בשום מקום מחירים ברמת התחנה: נקודה באוקראינה מקבלת כעת את הממוצע של המחוז שלה במקום הממוצע הארצי, וחוזרת לממוצע הארצי רק כאשר אין ציטוט עבור המחוז.

תשובה מרמת region כוללת את קוד המחוז (ערך ISO 3166-2 כגון UA-46), region_name ו-region_center_dist_km, וכן את אותם שדות מחיר כמו ברמת המדינה. המשיכו לפצל את הקוד לפי resolution, לעולם לא לפי מבנה התשובה; תשובות station ו-country נותרו ללא שינוי.

נקודת הקצה החדשה GET /api/v2/data/fuel-local?lat=&lon= מחזירה את מחיר הדלק הזמין הטוב ביותר עבור כל נקודה באירופה. במקומות שבהם יש לנו נתונים ברמת התחנה היא משיבה במחירי התחנות הקרובות ביותר, אחרת בממוצע הארצי של המדינה שבה נמצאת הנקודה — כולל אוקראינה, שבה אין בשום מקום מחירים ברמת התחנה.

כל תשובה כוללת את השדה resolution, המציין את הרמה שהשיבה: station (רשימת תחנות עם distance_km, כל אחת במטבע שלה) או country (אובייקט אחד של ממוצעים ארציים). פַּצלו את הקוד לפי resolution, לעולם לא לפי מבנה התשובה. זמין מ־/api/v2/ ואילך; fuel, fuel-stations ו־fuel-cheapest נותרו ללא שינוי.

המוצרים fuel-stations ו-fuel-cheapest מכסים כעת הרבה יותר תחנות בגרמניה, והמחירים מתעדכנים לאורך כל היום — כולל באזורים כפריים. הפרמטר fuel_type מקבל 13 סוגי דלק: diesel, e5, e10, superplus, super100, premdiesel, truckdiesel, hvo, lpg, cng, adblue, e85 ו-lng. כאשר אף תחנה אינה תואמת לשאילתה, התשובה כוללת אובייקט coverage עם רשימת המדינות שעבורן קיימים נתוני תחנות.

הפרמטר radius= מתקבל כעת ככינוי תואם ל-radius_km בכל מוצר שמתעד אותו. המוצרים fuel-stations ו-fuel-cheapest מחזירים אובייקט coverage נוסף (רשימת המדינות שיש בהן תחנות בתוספת הערה) במקום תוצאה ריקה ללא הסבר כשאין תחנה תואמת. אובייקטי הגבול של route-plan כוללים כעת מפתח נוסף wait_basis (car_lane מול vehicle_lane), כך שלקוחות יכולים לדעת מתי נתוני ההמתנה למשאיות מגיעים למעשה מנתיב הרכבים הפרטיים. ההתאמה של מעברי גבול למשאיות לאורך המסלול מדויקת הרבה יותר: נפילה לאחור לנתיב הרכבים הפרטיים עבור זוגות מעברים ללא נתוני נתיב משאיות, הגנה מפני כיוון שגוי, סף מרחק מחמיר יותר והסרת כפילויות של מעברים באותו מיקום. כל השינויים הם תוספתיים; אין שינויים שוברי תאימות.

לעמוד הנחיתה למפתחים יש כעת קטעים מעוגנים (#products, #plans, #quickstart, #integrations, #datasets, #apps, #companies, #showcase) עם ניווט קפיצה, וכל כרטיס מוצר מקושר לעמוד התיעוד שלו. קטע חדש Mobile apps מציג את Kordon Online ו-Truck Bans עם קישורים ל-Google Play. השלמת תרגומים: היסטוריית חיוב, שגיאות התחברות, קישורי sandbox וכפתור בחירת התוכנית מתורגמים כעת בכל 25 השפות.

תגובת ה-fleet beacon (POST /api/v1/fleet_position.php) כוללת כעת מערך messages שמעביר הודעות ממתינות מהבעלים לנהג. הזנת JSON חדשה בזמן אמת עבור בעלים בלבד (?ajax=live) וכרטיס "הודעות לנהגים" בלוח הבקרה של הצי. עמוד הזמנת נהג חדש /{lang}/get-nakbus (25 שפות).

הכותרת, התיאור (title, desc) של product_fleet_vehicles/live/history ופרמטרי fleet-history תורגמו בכל 25 שפות פורטל המפתחים.

/api/v1/data/truck-bans מחזיר כעת את אותה קבוצת שדות ברמה העליונה, ללא קשר לשאילתה שהפעילה את התגובה. בעבר, שאילתה עבור מדינה ללא איסורים בלוח שנה, ppid לא מזוהה, או התאמה רגילה במסד הנתונים יכלו כל אחת להשמיט שדות שונים (למשל country, covered_countries, ppid). כעת כל תגובה כוללת באופן עקבי את as_of, bans_by_country, countries_not_covered, country, covered_countries, current_bans, is_ban_active, lang, page_url, ppid, relevant_countries, source, success, summary, total_bans ו-upcoming_bans (null או ריק כאשר לא רלוונטי), מה שמפשט את הניתוח בצד הלקוח.

תשעה מוצרים חדשים לפי שירות. אלה המבוססים על מיקום מקבלים lat/lon או city + country (אנחנו מבצעים geocoding לעיר עבורכם): /api/v2/data/truck-parkings, /api/v2/data/shops, /api/v2/data/showers, /api/v2/data/restaurants, /api/v2/data/industrial, /api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest (תחנות מדורגות לפי מחיר עבור סוג דלק) ו-/api/v2/data/internet-points; התוצאות כוללות distance_km ומוגבלות על ידי radius. /api/v2/data/vignettes עונה האם מדינה דורשת ויניטה, עם מחירים עדכניים. המוצר הקיים pois תומך כעת ב-lon וב-radius כפי שמתועד, ומצב mode=nearest של המוצר fuel מקבל גם הוא lon. כל התשעה זמינים בסביבת ה-sandbox.

כל איסור ב-/api/v1/data/truck-bans כולל כעת restriction_type (General / Local / Sunday / Holiday / Seasonal), restriction_details (ההיקף המדויק או הכבישים המושפעים) ו-min_weight_tons. details_url מפנה כעת לדפים לפי מדינה באתר nakordoni.eu. פרמטר אופציונלי חדש, lang, בוחר את שפת שמות המדינות והתקציר; ברירת המחדל היא כעת אנגלית.

ערך ?ppid= שגוי מחזיר כעת את הסיבה האמיתית במקום "Request failed" סתמי: השגיאה מציינת את הפרמטר, את המבנה הצפוי id_<number> ומפנה אל /api/v1/data/checkpoints. טבלאות הפרמטרים של stats, forecast, update-info, weather ו-bus-carriers מציגות כעת את הדוגמה id_13 בכל 25 השפות.

מעטפת הפורטל המעוצבת מחדש (סרגל עליון, סרגל צד עם אייקונים, לוח מחווני KPI, פריסות מבוססות כרטיסים) היא כעת חוויית ברירת המחדל לכל חשבונות המפתחים המחוברים — מוקדם מתאריך ההשקה המתוכנן, 10 באוגוסט. השתמשו ב- ?v=1 כדי לחזור לפריסה הקלאסית בכל עת.

כל עמודי פורטל המפתחים — עמוד הבית, התיעוד, לוח הבקרה, AI Studio, סביבת הניסוי, פניות התמיכה, הבקשות, הייצוא, הצי, החדשות, יומן השינויים ועמודי החשבון — אינם טוענים עוד שום סקריפט פרסום או שטח פרסום. הדבר חל על כל הפורטל, ולא רק על ההתחברות וההרשמה כפי שהיה קודם.

תכננו נסיעה חוצת גבול שלמה בקריאה אחת: /api/v2/data/route-plan מחזיר את המסלול, את מעברי הגבול שנמצאים עליו באמת עם התור החי או תחזית לשעת ההגעה שלכם, ואת העצירות שנהג באמת עושה — מנוחה, אוכל, תדלוק — הכול על ציר זמן אחד.

הגבול הוא חלק מציר הזמן הזה. תור ארוך נחשב כהפסקה שממילא הגיע זמנה ומאפס את שעון הנהיגה, ולכן שלוש שעות המתנה לעולם אינן מוצגות כשלוש שעות ועוד מערך שלם של הפסקות שאיש לא עשה. למכוניות פרטיות חל מודל נהיגה בטוחה; אוטובוסים ומשאיות מקבלים את מנוחת החובה לפי EU 561/2006, וזמן השירות של האוטובוסים מכויל על יותר מ-1000 לוחות זמנים בינלאומיים מורשים. הוסיפו stop_places=1 כדי לתת לכל עצירה חניון או תחנת דלק אמיתיים, ו-via=lat,lon כדי לעבור במעבר אחר.

חדש בתפריט הפורטל: מצגת — מצגת חיה ותמיד עדכנית של פלטפורמת הנתונים nakordoni, מותאמת לשוק שלכם (ביטוח, תיירות, לוגיסטיקה, מובילים, מדיה, ניווט, דלק, פינטק, המגזר הציבורי או פרויקטים אישיים). היא מציגה נפחי פלטפורמה אמיתיים ל-30 יום, את השימוש שלכם ב-API, סטטיסטיקות זמני תגובה ומגבלות, והמלצת תוכנית כאשר הקריאות שלכם מגיעות לגבולות המסלול החינמי. בחרו או אשרו את השוק (או השווקים) שלכם בעמוד, בפרופיל — או בעת ההרשמה. היא נפתחת אוטומטית בביקור הראשון; את הפתיחה האוטומטית אפשר לכבות בעמוד עצמו.

אם לעוזר מופעלת הזנה אך הקריאה אינה נושאת את ההקשר שההזנה צריכה — למשל queue בלי ppid— ההזנה מדולגת כעת עוד לפני כל בקשה ו אינה מחויבת. קודם לכן היא נקראה בכל זאת, נכשלה ועדיין עלתה יחידה. הסטודיו מציג מה כל הזנה צריכה, מחשב מחדש את המחיר ככל שאתם ממלאים את ההקשר, ומסמן את התוצאות ✓ רצה / ⊘ דולגה, ללא חיוב / ✕ נכשלה; ה-API מחזיר data.feeds_skipped , שמציין בדיוק איזה פרמטר להעביר.

התשובות אינן מזכירות עוד הזנות, מקורות נתונים או כל דבר טכני: הזנה חסרה היא לכל היותר משפט פשוט אחד למשתמש הקצה, לעולם לא שם פנימי. הזנות שיש להן רק מסננים אופציונליים (כמו fuel שצומצמה למדינה שאין לנו עליה נתונים) חוזרות כעת למאגר הנתונים הרחב במקום לא להחזיר דבר.

חדש: /{lang}/developers/studio. בנו עוזר AI שעונה מתוך התוכן שלכם ומתוך נתוני הגבול החיים שלנו . תנו לנו את קובצי ה-markdown שלכם, או פשוט ציינו את העמודים ואנחנו נביא ונאנדקס אותם — אתם מתחזקים רק את הקבצים שלכם. בחרו באילו מההזנות שלנו הוא רשאי להשתמש (תור, תחזית, חלופות, סטטיסטיקה יומית, דלק, איסורי משאיות, ימי ראשון מסחריים, חגים, מצב הכבישים, מובילי אוטובוסים, נקודות עניין, מטבע), בחרו רמת מודל (מהיר / מאוזן / מקצועי — היא שקובעת את המחיר), כתבו הנחיות משלכם עם מצייני מקום {{feed.slug}} שמציינים בדיוק היכן הנתונים שלנו ישובצו בתשובה, והוסיפו משפט סיום משלכם שיצורף לכל תשובה. תבניות מוכנות: עוזר נסיעות אישי, עוזר עבודה/הובלה, עוזר מכירות לביטוח וכרטיס ירוק.

בדקו אותו בסטודיו (30 תשובות ביום, בנפרד ממכסת ה-API שלכם), ואז קראו לו בסביבת הייצור בכתובת GET /api/v2/data/assistant-custom?assistant_id=N&q=…. המחיר לתשובה = יחידות רמת המודל + יחידה אחת לכל הזנה מופעלת, ומוחזר ב- X-Devapi-Units. המוצר קיים רק ב-v2 — כתובת v1 מחזירה unsupported_version. המוצר הקיים assistant לא השתנה.

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

חדש: שרת MCP אמיתי בכתובת https://nakordoni.eu/mcp, שחושף תת-קבוצה בטוחה וניתנת לקריאה בלבד של ה-API (status, checkpoints, border queue, live queue, forecast) ככלי MCP. אותו מפתח API ואותה מכסה כמו ב-REST API. כרטיס השרת בכתובת /.well-known/mcp/server-card.json. ראו את הסעיף שרת MCP בתיעוד.

שינוי השם ל-„Live Queue & Freshness API“ המתואר למטה לא הגיע בפועל לעמוד התיעוד . העמוד מציג את כותרת כל מוצר דרך חיפוש תרגום, שנופל לכותרת נקודת הקצה רק כשאין תרגום — ותרגום כבר היה קיים, קפוא על השם הישן, בכל 25 שפות הממשק. מעתה הוא גובר על כל עדכון עתידי של הכותרת הבסיסית, עד שיעודכן גם הוא.

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

אם אתם מתשאלים נתוני תור חי לעיתים קרובות, ייתכן שאתם מבזבזים מכסה כבדה שלא לצורך. /update-info הוא מסיווג רגיל וכבר מחזיר את הערך החי:

GET /api/v1/data/update-info?ppid=id_13

הוא מחזיר queue_now, freshness, age_minutes, is_realtime, status, timestamp ו- timezone. השתמשו בו לרענון התכוף על חשבון המכסה היומית הרגילה שלכם, ושמרו את /queue, /multi ו- /forecast (כולם מסיווג כבד) למקרים שבהם אתם צריכים wait_min, את שדות המגמה או היסטוריה.

בנקודת הקצה עצמה דבר לא השתנה — רק בתיעוד שלה. היא הופיעה בשם „Data Freshness API“ והתיאור שלה הזכיר רק את דירוג הטריות, מעולם לא את queue_now, כך שהיה קל לפספס אותה. כעת שמה „Live Queue & Freshness API“, והשדות המוחזרים מפורטים במפורש. תודה למפתח שהעלה את הנושא.

חלק מהבקשות שנכשלו החזירו HTTP 200 עם ok: true והשגיאה הייתה קבורה בתוך data — כך שהתבנית המתועדת if (!ok) throw לא יכלה לזהות אותן, והקריאה חויבה בכל זאת. הקריאות המושפעות מחזירות כעת HTTP 400 עם ok: false ועם error.code / error.messageתקינים, כמתועד. נצפה ב- fuel-cities עם מדינה שאינה נתמכת וב- travel-matrix עם קואורדינטות שגויות.

בנפרד: פרמטר חובה חסר החזיר 500 internal_error במקום 400 bad_request (גוף תשובת 4xx מהשירות הפנימי נזרק לפני שנקרא הסטטוס שלו). כעת מוחזר 400 bad_request עם ההודעה של השירות הפנימי — למשל search ללא ?name=.

תשובות מוצלחות לא השתנו, בית אחר בית — אותם שדות, אותם פרמטרים, אותה עלות מכסה. אם הלקוח שלכם כבר מסתעף לפי ok, אין צורך בשינוי. אם הוא התעלם מ- ok וקרא ישירות את data , הוא יראה כעת מעטפות שגיאה בקריאות שתמיד נכשלו ממילא.

תוקן באג שבו /multi עלול היה להחזיר מספר שגוי של רכבים בתור עבור חלק ממעברי הגבול — בעיקר בבלקן ובגבול הונגריה–סרביה — בכל פעם שהמטמון שלו היה קר. מסלול הגיבוי קרא טבלה שאינה מחזיקה נתוני תור עבור אותם מעברים, ודיווח ערכים לא קשורים כמספר מכוניות. דוגמאות שנמדדו: מעבר עם 12 מכוניות דיווח 6, וכמה מעברים עם תורים אמיתיים דיווחו 0.

שלושה שינויים שאולי תבחינו בהם:

• found: false פירושו כעת שבאמת אין נתוני תור עדכניים. קודם לכן יכולתם לקבל found: true עם queue_now: 0מומצא.
• wait_status, trend_percent ו- trend_direction מוחזרים כעת גם בבקשות קרות — קודם הם היו null .
• נקודת הקצה עוברת למסלול הגיבוי גם כאשר תמונת המטמון שלה מיושנת (בת יותר מ-24 שעות), ולא רק כשהיא חסרה.

אין שינויים בפרמטרים של הבקשה, בעלות המכסה או במבנה התשובה.

תוקן באג שגרם לכל קריאת /multi להיות מחויבת פעמיים - פעם אחת בבדיקה גנרית של יחידה אחת, ופעם נוספת בנוסחת העלות המשתנה של ה-endpoint עצמו (N PPID × תת-מוצרים). כעת קריאה עולה בדיוק ⌈(N×M)/2⌉ יחידות כפי שמתועד, ללא חיוב נוסף.

בנוסף, בעמוד התיעוד נוסף תג מחלקת מכסה (Standard/Heavy) לכל מוצר, כך שברור במבט אחד באיזו מכסה יומית endpoint משתמש.

country ו-countries מוזגו לפרמטר אחד (1-15 קודים מופרדים בפסיקים). פרמטר compare_to חדש: השוואת חגים זהים מול שונים בין מדינות, פועל יחד עם upcoming+days. lang מקבל כעת מספר שפות (מוסיף אובייקט names). days=0 או השמטתו פירושו כעת ללא הגבלה במצב upcoming.

חגים ציבוריים רשמיים לכל מדינה אירופית — תאריכים, שמות מקומיים וסוג. מבוסס על אותו שירות Nager.Date / OpenHolidaysAPI (עם לוח שנה של קוסובו המחושב מקומית) שמפעיל את עמוד לוח החגים של nakordoni.eu ואת גורמי לוח השנה של מערכת החיזוי.

• ?country=PL&year=2026 — רשימת חגים לשנה מלאה עבור מדינה אחת
• ?upcoming=1&days=30 — רשימה שטוחה של חגים קרובים בין מדינות
• ללא פרמטרים — אינדקס של מערך מדינות ליבה עם כל חג הבא

נוסף המוצר currency — שערי חליפין מבוססי EUR עבור PLN, CZK, HUF, USD, GBP, CHF, NOK ו-UAH, ממקור Frankfurter (ECB) ונשמרים במטמון למשך 6 שעות. ללא פרמטרים, תמיד מחזיר את טבלת השערים המלאה. ראו תיעוד.

הטמיעו איסורי נסיעה חיים למשאיות באירופה באתר שלכם — וידג'ט iframe חינמי עם 3 עיצובים (light, dark, board), 5 שפות (en, uk, pl, de, ru), מסנן אופציונלי לפי מדינה וסטטוס «פעיל כעת» חי. אין צורך במפתח API. הגדירו והעתיקו את הקוד בכתובת nakordoni.eu/en/for_truck_drivers/traffic_bans/widget. מעדיפים נתונים גולמיים? מוצר ה-API בשם truck-bans וה-feed הציבורי בפורמט JSON נותרים זמינים.

שלוש תוספות, כולן תואמות לאחור — v1 ללא שינוי.

גרסאות לכל endpoint. קיימת כעת כתובת בסיס /api/v2/. היא פועלת לכל endpoint: רק endpoints שהשתנו בפועל מתנהגים אחרת תחת v2; כל endpoint אחר מגיש בשקיפות את תגובת v1 שלו (כלומר /api/v2/data/queue = אותם נתונים כמו v1, רק עם "api_version":"v2"). אין צורך להגר endpoints שעובדים.

border בגרסה v2 הוא כיווני. סדר הנתיב הוא כיוון הנסיעה:

GET /api/v2/data/border/1/2/6   → buses UA→PL (Ukrainian-side crossings)
GET /api/v2/data/border/2/1/6   → buses PL→UA (Polish-side crossings)

כל מעבר גבול מקבל גם אובייקט direction {from,to} וערך boolean בשם stale, ו-?max_age_min=N מחזיר רק מעברים שעודכנו לאחרונה. (v1 border עדיין מחזיר את שני צדי הגבול ללא תלות בסדר — ללא שינוי.)

Sandbox אינטראקטיבי. מפתחים מחוברים יכולים כעת לנסות כל endpoint מהדפדפן בכתובת Developers → Sandbox — בחרו endpoint, גרסה ואחד מהמפתחות שלכם, כווננו פרמטרים וראו את התגובה החיה. לבדיקות Sandbox יש תקציב יומי נפרד משלהן (50 קריאות ליום) והן לעולם אינן נוגעות במכסת ה-API החיה שלכם.

התיעוד מפוצל כעת לכל endpoint (Developers → API Docs) עם בורר גרסה על endpoints שיש להם יותר מגרסה אחת.

שני גורמים חדשים שולבו בנוסחת זמן ההמתנה, לצד כיווני section_mode ומזג האוויר הקיימים:

• service_rate — מכוניות לדקה נמדדות המעובדות כעת מול קצב הבסיס המוגדר של מעבר הגבול. כפלי, מוגבל ל-0.5x-1.5x.
• shift_change — השפעת חילופי המשמרת המקומיים של מעבר הגבול בשעות 08:00/20:00 של משמר הגבול. חיבורי (דקות), לא כפלי — מיושם רק בטווח של +/-60 דקות מחילוף משמרת, דורש היסטוריית מדגם מינימלית, מוגבל ל-+/-120 דקות.

advanced_wait_min הוא כעת round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min. שני הגורמים משתקפים גם ב-driver_reported.prognosed_advanced_wait_min לצורך השוואות היסטוריות.

כחלק מסקירת אבטחה/פרטיות, השדות הבאים הוסרו — הם חשפו פרטי מימוש פנימיים (טקסונומיית מקור הנתונים שלנו, מזהי שורות DB, הערות pipeline פנימיות, שדות לא בשימוש/מתים) ללא ערך מוצרי אמיתי:

• id ו-corrected — הוסרו מאובייקטי השורה של queue
• source (מחרוזת גולמית, למשל "line") — הוסר מ-queue, multi ו-update-info. בלוק ה-update_info של update-info ו-multi עדיין נושא source_category/source_label_en (אוצר מילים ציבורי קטן); בלוק ה-queue של queue ו-multi כבר אינו נושא שום שדה source כלל
• traffic_status — הוסר מ-border; הוא תמיד היה null ומעולם לא אוכלס על ידי אף חלק במערכת

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

ניצול המכסה היומי (usage.used בכל תגובה) יכול כעת להיות ערך עשרוני (למשל 67.5) במקום תמיד מספר שלם. זוהי תופעת לוואי של חיוב queue-advanced בתעריף שברי — ראו למטה. usage.limit אינו מושפע והוא תמיד מספר שלם. אם הלקוח שלכם מגדיר את usage.used באופן קפדני כמספר שלם, אנא הרחיבו אותו לקבל עשרוני/float.

שלושת המוצרים הללו מחזירים כעת את אותם שדות סטטוס חי שהאתר מציג: wait_status (green/yellow/red, בהתבסס על ההיסטוריה האחרונה של מעבר גבול זה) ו-trend_percent/trend_direction (up/up-slight/down/down-slight/stable, בהשוואת 3 השעות האחרונות). תוספתי בלבד.

בשורות data[] של /api/v1/data/queue היה בעבר wait_time: null עבור רוב המקורות — רק כמה הזנות upstream מדווחות זמן המתנה ישירות. שורות ללא זמן כזה מקבלות כעת את ההערכה הסטנדרטית , מסומנות ב-boolean חדש בשם wait_time_estimated כדי שתוכלו להבחין בין נתון מדווח אמיתי לבין מחושב.

queue-advanced עולה כעת 1.5 יחידות לכל קריאה במקום 1 (משקף את חיפושי התנועה/מזג האוויר/דיווחי הנהגים הנוספים שהוא מבצע) — ראו usage.used למעלה. התגובה גם אינה כוללת עוד total_crossing_time, ו-driver_reported הוא כעת רק {wait_min, ts, age_min} — שדות ההשוואה הקודמים בין תחזית למציאות (prognosed_wait_min, diff_min, historical_section_mode, historical_weather וכו') הוסרו. section_mode, weather, advanced_wait_min ו-exceeds_crossing_time ללא שינוי.

/api/v1/data/truck-bans מחזיר כעת, עבור כל מדינה ב-bans_by_country, status (active/clear) בתוספת active_window, next_window, local_time ו-tz — מחושבים באזור הזמן של אותה מדינה, כך שאינכם צריכים עוד להעריך חלונות איסור גולמיים מול שעון בעצמכם. התגובה מוסיפה גם רשימת covered_countries ברמה העליונה וחותמת זמן as_of ב-UTC.

GET /api/v1/data/truck-bans?country=PL

תוספתי בלבד — השדות הקיימים current_bans/upcoming_bans/bans_by_country ללא שינוי. ?country= לא ידוע מחזיר כעת תוצאה ריקה עם countries_not_covered במקום האיסורים של כל מדינה.

מוצר חדש להצטרפות מרצון שמכוונן את זמן ההמתנה הסטנדרטי לפי זרימת תנועה חיה ומזג אוויר. מחזיר את הפירוט המלא של כל כיוונון.

GET /api/v1/data/queue-advanced?ppid=id_13

ניתן לפי בקשה — פתחו כרטיס Data מלוח הבקרה שלכם כדי להפעיל אותו.

/api/v1/data/border מחשב כעת נכון את wait_min עבור כל מעבר גבול בתגובה, בהתאמה למוצרים queue ו-multi. בעבר שדה זה תמיד היה null.

/api/v1/data/forecast משתמש כעת באופן אמין במודל ה-ensemble v4 עבור כל ערך prediction_steps (בעבר חלק מהאופקים הלא-סטנדרטיים היו יכולים לחזור בשקט למודל ישן יותר). גם גורם מזג האוויר המזין את ה-ensemble תוקן וכעת משקף באמת תנאים חיים (גשם, שלג, רוח, ערפל) במקום לדווח תמיד שאינו זמין.

מפתחים מאושרים יכולים כעת להוריד נתוני תור גבול היסטוריים בממוצע שעתי עבור עד 5 מעברי גבול (חלון מתגלגל של עד 90 יום) כ-CSV או NDJSON מלשונית Data export החדשה. הנתונים הם מפורסמים בלבד ועברו בקרת איכות; חותמות הזמן הן ב-UTC. צריכים גישה? פתחו כרטיס Data.

אין עדיין אתר? כעת תוכלו ליצור חשבון מפתח על ידי תיאור היכן וכיצד אתם מתכננים להשתמש בנתונים שלנו, במקום להיות מחויבים להזין כתובת URL של עמוד חי. הוסיפו את ה-URL האמיתי מאוחר יותר מלוח הבקרה שלכם (Account & data → Your project) ברגע שהאתר או האפליקציה שלכם חיים — קישור נראה חזרה ל-nakordoni.eu באותו עמוד נדרש על פי התנאים שלנו.

מפתחים יכולים כעת לשלוח חדשות משלהם הקשורות לגבול לקו החדשות של Nakordoni. אם העורכים שלנו יפרסמו זאת, תקבלו קישור נכנס מסוג dofollow הניתן לאינדוקס לשירות שלכם (שם המפרסם + שורת מקור) ואנו מתרגמים את המאמר לכל 24 השפות בחינם.

מאמר אחד בשבוע הוא בחינם; מאמרים נוספים הם תוספת בתשלום. בחרו 'אנו עשויים לערוך מעט + להוסיף קישורים פנימיים' או 'פרסמו כמו שזה'. שלחו ועקבו אחר סטטוס הבדיקה תחת Developers → Submit news.

ה-Multi-Checkpoint API (/api/v1/data/multi) מחייב כעת מכסה בשיעור ⌈(N PPIDs × מוצרי-משנה) / 2⌉ — מחצית מהעלות של קריאות בודדות שוות ערך. בקשה ל-10 מעברי גבול עם שני מוצרי-המשנה עולה כעת 10 יחידות במקום 20. הכותרת X-Devapi-Units ו-meta.units_consumed בתגובה משקפים את הסכום המוזל.

קבלו סטטוס תור חי ורעננות נתונים עבור עד 20 מעברי גבול בקריאת API אחת — מיועד לבוני לוחות בקרה שכיום סוקרים PPIDs רבים בלולאה.

המכסה נספרת בהוגנות כ-N PPIDs × מוצרי-משנה שהתבקשו, כך שהשימוש הכולל זהה לקריאות בודדות — אך עם הלוך-ושוב אחד במקום רבים. דפוסים בסגנון GreenTravel יורדים מ-24+ קריאות בשעה ל-2.

GET /api/v1/data/multi?ppids=id_2,id_13,id_15,id_59&include=queue,update-info&lang=en

• include=queue — queue_now נוכחי, wait_min מוערך, גיל הנתונים ושם מעבר הגבול
• include=update-info — רעננות נתונים, סיווג מקור, גיל בשניות/דקות
• מקסימום 20 PPIDs לכל בקשה; שלבו את שני מוצרי-המשנה בקריאה אחת לקבלת נתוני לוח בקרה מלאים
• התגובה כוללת meta.units_consumed כדי שתוכלו לעקוב אחר ניצול המכסה בדיוק

תגובת המוצר queue כוללת כעת אובייקט snapshot ברמה העליונה עם הנתונים העדכניים ביותר בזמן אמת וזמן המתנה חזוי מחושב — אותה נוסחה המשמשת בקטע ה-hero של nakordoni.eu:

snapshot.queue_now  — current cars in queue
snapshot.wait_min   — prognosed wait time (minutes)
snapshot.updated_at — when the queue data was recorded
snapshot.age_min    — minutes since last update
snapshot.source     — data source identifier

מערך ה-data (רשומות היסטוריות) ללא שינוי — זוהי תוספת תוספתית בלבד. לקוחות שאינם קוראים את snapshot אינם מושפעים.

שאילתו את כל מעברי הגבול על גבול מסוים + סוג רכב בקריאה אחת במקום לבצע בקשה אחת לכל PPID.

GET /api/v1/data/border/{origin}/{destination}/{crossing_type}

• תומך במדינת יעד אחת, ברשימה מופרדת בפסיקים, או ב-all להרחבה לכל שכן מנוטר בבת אחת.
• התוצאות ממוינות לפי queue_now בסדר עולה (התור הקצר ביותר תחילה).
• מותאם לשפה במלואו: הוסיפו ?lang=uk (או כל אחת מ-22 השפות הנתמכות שלנו) כדי לקבל שמות מעברי גבול באותה שפה.

גלו ערכי PPID של מעברי גבול לפי שם ללא עיון בספרייה המלאה.

GET /api/v1/data/search?name=Krakovets,Shehyni&lang=en

• מקבל שם יחיד או רשימה מופרדת בפסיקים (עד 20).
• מחפש בכל 24 שפות התרגום — העבירו שם באוקראינית, פולנית, גרמנית או כל שפה נתמכת והוא יתאים.
• מחזיר את כל ה-PPIDs באותו מיקום מקובצים לפי סוג רכב (מכונית / אוטובוס / הולך רגל / משאית).

המוצר alternatives מקבל כעת ?lang= בכל 22 השפות הנתמכות (בעבר רק 12).

פרמטר crossing_type חדש מאפשר לכם לדרוס את מסנן סוג הרכב — למשל העבירו crossing_type=4 כדי לקבל חלופות למכוניות גם בעת שאילתה מ-PPID של אוטובוס.

שדה crossing_type_label בתגובות checkpoints, border ו-search מתורגם כעת לשפה המבוקשת בכל 22 השפות הנתמכות. שדות שם המדינה (origin_name, destination_name) עוקבים אחר אותה שפה.

פורטל ה-Nakordoni Developer API פעיל בכתובת /en/developers. הירשמו למפתח Explorer חינמי (200 בקשות ליום) כדי לגשת לנתוני תור גבול, תחזיות, מחירי דלק, נקודות עניין לנהגים ועוד.

מוצרים זמינים בהשקה: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.