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

איסור החום המחושב לאוקראינה — מוחזר עם 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
• tmin/tpercar — הוסרו מ-queue, border ו-multi (קבועי נוסחת זמן ההמתנה; wait_min/wait_time שכבר חושבו אינם מושפעים)
• 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 מדווחות זמן המתנה ישירות. שורות ללא זמן כזה מקבלות כעת את ההערכה הסטנדרטית tmin + queue×tpercar, מסומנות ב-boolean חדש בשם wait_time_estimated כדי שתוכלו להבחין בין נתון מדווח אמיתי לבין מחושב.

queue-advanced עולה כעת 1.5 יחידות לכל קריאה במקום 1 (משקף את חיפושי התנועה/מזג האוויר/דיווחי הנהגים הנוספים שהוא מבצע) — ראו usage.used למעלה. התגובה גם אינה כוללת עוד tmin, tpercar או 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 (ומחזיר tmin/tpercar) עבור כל מעבר גבול בתגובה, בהתאמה למוצרים 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   — tmin + queue_now × tpercar (minutes)
snapshot.tmin       — minimum crossing time (minutes)
snapshot.tpercar    — added time per vehicle (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.