ערכות SDK וכלים
כל מה שצריך כדי לבנות על Navo24.
מפרטי OpenAPI לכל מוצר, לקוח עם טיפוסים בשפה שלכם בפקודה אחת, אוספי Postman מוכנים, שרתי MCP לעוזרי בינה מלאכותית וכפתור בדיקה למקלט ה-webhook שלכם.
בחרו איך המערכת שלכם מדברת עם Navo24.
REST API
קראו ל-API מהקוד שלכם
השרת שלכם שולח מכולה, שטר מטען אווירי או נתיב אל https://api.navo24.com/v1/<product> עם מפתח bearer ומקבל JSON בחזרה. השתמשו בלקוח שנוצר, באוסף Postman או ב-HTTP פשוט.
קראו את המדריך למתחיליםMCP
תנו לעוזר בינה מלאכותית לקרוא לכלים
Claude, Cursor, ChatGPT או כל לקוח MCP מתחברים לשרת MCP של Navo24 וקוראים למעקב, ללוחות הפלגה, לתעריפים ולתכנון העמסה ככלים. אין צורך לכתוב קוד לקוח.
מדריך מהיר ל-MCPספריות לקוח
לקוח עם טיפוסים בשפה שלכם, בפקודה אחת.
כל מוצר מפרסם מפרט OpenAPI 3 שכבר מצביע על api.navo24.com. הריצו עליו את OpenAPI Generator ותקבלו מודלים, מחלקת API לכל אזור וטיפול באימות. אנחנו מייצרים את כל ששת היעדים שלהלן מהמפרטים שלנו לפני כל גרסה.
חבילות Navo24 רשמיות ל-npm, ל-PyPI ולמאגרים האחרים עדיין לא פורסמו. עד שיפורסמו, צרו את הלקוח בעצמכם: הוא נשאר מסונכרן עם ה-API בכל פעם שתייצרו אותו מחדש.
מדריך מפורט עם עטיפת fetch שנכתבה ידניתnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g typescript-fetch \
-o ./navo24-tracking-tsnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g python \
-o ./navo24-tracking-pynpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g php \
-o ./navo24-tracking-phpnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g java \
-o ./navo24-tracking-javanpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g csharp \
-o ./navo24-tracking-dotnetnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g go \
-o ./navo24-tracking-goהחליפו את tracking.json ב-air.json, schedules.json, loading.json או rates.json כדי לקבל את שאר המוצרים. נדרשים Node.js 18+ ו-Java 11+; תמונת ה-Docker openapitools/openapi-generator-cli מקבלת את אותם דגלים.
OpenAPI ו-Postman
מפרטים ואוספים לכל מוצר.
הורידו את המפרט ליצירת קוד או לבדיקות חוזה, או ייבאו את האוסף ושלחו את הבקשה הראשונה תוך דקה. הגדירו את המשתנה apiKey למפתח שלכם; baseUrl כבר ממולא.
Bruno ו-Insomnia מייבאים את אותו אוסף או את קובץ ה-OpenAPI ישירות.
כלים
כלים נוספים שמגיעים עם כל מפתח.
דוגמאות קוד
לכל נקודת קצה במסמך העזר יש בקשות מוכנות להעתקה ב-curl, JavaScript ו-Python, עם תגובות אמיתיות.
עיינו במסמך העזרשרתי MCP
שרת MCP לכל מוצר, ובנוסף mcp.navo24.com למרחקים, CO2e, אוניות וטיסות. אותו מפתח כמו ב-API.
שרת MCP של Navo24שליחת בדיקה ל-webhook
שלחו אירוע בדיקה חתום למקלט שלכם מכל מוצר ובדקו כותרות, מעטפה וניסיונות חוזרים מקצה לקצה.
מדריך webhooksאפליקציות להטמעה
מעקב, תעריפים ולוחות הפלגה באתר של לקוח, במיתוג שלו, עם תגית script אחת ומפתח נעול לדומיין.
הטמיעו את האפליקציותפיד אירועי DCSA
אירועי Track & Trace במבנה DCSA, למערכות שכבר עובדות לפי התקן.
פיד DCSAשגיאות ומגבלות קצב
מעטפת שגיאה אחת לכל המוצרים, קודי הסטטוס שלפיהם כדאי להסתעף ואיך ניסיונות חוזרים צריכים להמתין בהדרגה.
שגיאות ומגבלותWebhooks
בדקו את המקלט שלכם
צרו webhook ובקשו מאיתנו ping. הוא עובר באותו מסלול כמו אירוע אמיתי: אותן כותרות, אותה חתימה, אותו סולם ניסיונות חוזרים.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"