Skip to content
Navo24Navo24

SDK και εργαλεία

Ό,τι χρειάζεστε για να χτίσετε πάνω στο Navo24.

Προδιαγραφές OpenAPI για κάθε προϊόν, typed πελάτης στη γλώσσα σας με μία εντολή, έτοιμες συλλογές Postman, διακομιστές MCP για βοηθούς AI και κουμπί δοκιμής για τον δέκτη webhooks σας.

Επιλέξτε πώς το σύστημά σας επικοινωνεί με το Navo24.

REST API

Καλέστε το API από τον δικό σας κώδικα

Το backend σας στέλνει ένα κοντέινερ, μια αεροπορική φορτωτική ή μια διαδρομή στο https://api.navo24.com/v1/<product> με κλειδί bearer και λαμβάνει JSON. Χρησιμοποιήστε έναν παραγόμενο πελάτη, τη συλλογή Postman ή απλό HTTP.

Διαβάστε το quickstart

MCP

Αφήστε έναν βοηθό AI να καλεί τα εργαλεία

Το Claude, το Cursor, το ChatGPT ή οποιοσδήποτε πελάτης MCP συνδέεται σε έναν διακομιστή MCP του Navo24 και καλεί παρακολούθηση, δρομολόγια, ναύλους και σχεδιασμό φόρτωσης ως εργαλεία. Χωρίς κώδικα πελάτη.

Quickstart MCP

Βιβλιοθήκες πελάτη

Typed πελάτης στη γλώσσα σας, με μία εντολή.

Κάθε προϊόν δημοσιεύει μια προδιαγραφή OpenAPI 3 που ήδη δείχνει στο api.navo24.com. Εκτελέστε το OpenAPI Generator πάνω της και παίρνετε μοντέλα, μια κλάση API ανά ενότητα και διαχείριση αυθεντικοποίησης. Πριν από κάθε έκδοση δημιουργούμε και τους έξι παρακάτω στόχους από τις δικές μας προδιαγραφές.

Επίσημα πακέτα Navo24 για npm, PyPI και τα υπόλοιπα μητρώα δεν έχουν δημοσιευτεί ακόμη. Μέχρι τότε, δημιουργήστε τον πελάτη μόνοι σας: μένει συγχρονισμένος με το API κάθε φορά που τον αναπαράγετε.

Οδηγός βήμα προς βήμα με χειρόγραφο wrapper για fetch
npx @openapitools/openapi-generator-cli generate \
  -i https://navo24.com/developers/openapi/tracking.json \
  -g typescript-fetch \
  -o ./navo24-tracking-ts

Αντικαταστήστε το 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}/test
curl
curl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
  -H "Authorization: Bearer $NAVO24_API_KEY"