SDK και εργαλεία
Ό,τι χρειάζεστε για να χτίσετε πάνω στο Navo24.
Προδιαγραφές OpenAPI για κάθε προϊόν, typed πελάτης στη γλώσσα σας με μία εντολή, έτοιμες συλλογές Postman, διακομιστές MCP για βοηθούς AI και κουμπί δοκιμής για τον δέκτη webhooks σας.
Επιλέξτε πώς το σύστημά σας επικοινωνεί με το Navo24.
REST API
Καλέστε το API από τον δικό σας κώδικα
Το backend σας στέλνει ένα κοντέινερ, μια αεροπορική φορτωτική ή μια διαδρομή στο https://api.navo24.com/v1/<product> με κλειδί bearer και λαμβάνει JSON. Χρησιμοποιήστε έναν παραγόμενο πελάτη, τη συλλογή Postman ή απλό HTTP.
Διαβάστε το quickstartMCP
Αφήστε έναν βοηθό AI να καλεί τα εργαλεία
Το Claude, το Cursor, το ChatGPT ή οποιοσδήποτε πελάτης MCP συνδέεται σε έναν διακομιστή MCP του Navo24 και καλεί παρακολούθηση, δρομολόγια, ναύλους και σχεδιασμό φόρτωσης ως εργαλεία. Χωρίς κώδικα πελάτη.
Quickstart MCPΒιβλιοθήκες πελάτη
Typed πελάτης στη γλώσσα σας, με μία εντολή.
Κάθε προϊόν δημοσιεύει μια προδιαγραφή OpenAPI 3 που ήδη δείχνει στο api.navo24.com. Εκτελέστε το OpenAPI Generator πάνω της και παίρνετε μοντέλα, μια κλάση API ανά ενότητα και διαχείριση αυθεντικοποίησης. Πριν από κάθε έκδοση δημιουργούμε και τους έξι παρακάτω στόχους από τις δικές μας προδιαγραφές.
Επίσημα πακέτα Navo24 για npm, PyPI και τα υπόλοιπα μητρώα δεν έχουν δημοσιευτεί ακόμη. Μέχρι τότε, δημιουργήστε τον πελάτη μόνοι σας: μένει συγχρονισμένος με το API κάθε φορά που τον αναπαράγετε.
Οδηγός βήμα προς βήμα με χειρόγραφο wrapper για fetchnpx @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
Προδιαγραφές και συλλογές για κάθε προϊόν.
Κατεβάστε την προδιαγραφή για παραγωγή κώδικα ή contract tests, ή εισαγάγετε τη συλλογή και στείλτε το πρώτο σας αίτημα σε ένα λεπτό. Ορίστε τη μεταβλητή apiKey με το κλειδί σας· το baseUrl είναι ήδη συμπληρωμένο.
Τα Bruno και Insomnia εισάγουν την ίδια συλλογή ή απευθείας το αρχείο OpenAPI.
Εργαλεία
Περισσότερα εργαλεία που συνοδεύουν κάθε κλειδί.
Δείγματα κώδικα
Κάθε endpoint στην τεκμηρίωση αναφοράς έχει έτοιμα αιτήματα για αντιγραφή σε curl, JavaScript και Python, με πραγματικές αποκρίσεις.
Περιηγηθείτε στην τεκμηρίωσηΔιακομιστές MCP
Ένας διακομιστής MCP ανά προϊόν, καθώς και το mcp.navo24.com για αποστάσεις, CO2e, πλοία και πτήσεις. Το ίδιο κλειδί με το API.
Διακομιστής MCP Navo24Δοκιμαστική αποστολή webhook
Στείλτε ένα υπογεγραμμένο δοκιμαστικό συμβάν στον δέκτη σας από οποιοδήποτε προϊόν και ελέγξτε headers, φάκελο και επαναλήψεις από άκρη σε άκρη.
Οδηγός webhooksΕνσωματώσιμες εφαρμογές
Παρακολούθηση, ναύλοι και δρομολόγια στον ιστότοπο ενός πελάτη με τη δική του ταυτότητα, με ένα tag script και κλειδί κλειδωμένο σε domain.
Ενσωμάτωση εφαρμογώνΡοή συμβάντων DCSA
Συμβάντα Track & Trace σε μορφή DCSA, για συστήματα που ήδη υποστηρίζουν το πρότυπο.
Ροή DCSAΣφάλματα και όρια αιτημάτων
Ενιαίος φάκελος σφαλμάτων σε όλα τα προϊόντα, οι κωδικοί κατάστασης που πρέπει να χειριστείτε και πώς πρέπει να καθυστερούν οι επαναλήψεις.
Σφάλματα και όριαWebhooks
Δοκιμάστε τον δέκτη σας
Δημιουργήστε ένα webhook και ζητήστε μας ένα ping. Ακολουθεί την ίδια διαδρομή με ένα πραγματικό συμβάν: ίδια headers, ίδια υπογραφή, ίδιο πρόγραμμα επαναλήψεων.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"