Skip to content
Navo24Navo24
Ξεκινήστε δωρεάν

Πρώτα βήματα

Πρώτα βήματα

Γρήγορη εκκίνηση με το API παρακολούθησης κοντέινερ: η πρώτη σας κλήση στο Navo24 σε δύο λεπτά χωρίς κλειδί, μετά κλειδί API και φορτίο σε παρακολούθηση.

Το Navo24 είναι πληροφόρηση εμπορευματικών μεταφορών που καλείτε απευθείας: παρακολούθηση κοντέινερ και αεροπορικών φορτωτικών (AWB), δρομολόγια πλοίων και αξιοπιστία, τιμές spot και σχεδιασμός φόρτωσης. Κάθε προϊόν προσφέρει REST API και τα περισσότερα και διακομιστή MCP, όλα με ένα μόνο κλειδί bearer.

Κάντε μια κλήση χωρίς λογαριασμό

Ο πιο γρήγορος τρόπος να δείτε πραγματικά δεδομένα είναι το δημόσιο endpoint του API παρακολούθησης κοντέινερ. Δεν χρειάζεται κλειδί.

curl -X POST https://api.trackingmcp.com/v1/track/public \
  -H "Content-Type: application/json" \
  -d '{"reference":"MEDU1234562"}'

Λαμβάνετε μια κανονικοποιημένη κατάσταση, το πλοίο, τα ορόσημα και ένα ETA που δείχνει αν είναι ακόμη πρόβλεψη:

{
  "ok": true,
  "data": {
    "identifier": "MEDU1234562",
    "identifier_type": "container_id",
    "carrier_code": "MSCU",
    "carrier_name": "MSC",
    "status": "in_transit",
    "eta": "2026-07-03T06:00:00Z",
    "eta_is_estimated": true,
    "origin": "Ningbo",
    "destination": "Rotterdam",
    "vessel": { "name": "MSC TERESA", "lat": null, "lng": null },
    "events": [
      {
        "description": "Loaded on vessel",
        "location": "Ningbo",
        "event_code": "LOAD",
        "unlocode": "CNNGB",
        "datetime": "2026-06-18T22:10:00Z",
        "actual": true
      }
    ]
  }
}

Τέσσερα πεδία μεταφέρουν το μεγαλύτερο μέρος της πληροφορίας:

  • Το identifier_type δείχνει τι συμπεράναμε ότι είναι πραγματικά ο αριθμός αναφοράς, κάτι που μπορεί να διαφέρει από την εκτίμησή σας.
  • Το eta_is_estimated είναι true όσο το ETA είναι πρόβλεψη, false όταν πρόκειται για την πραγματική άφιξη και null όταν δεν έχουμε καθόλου ETA. Μια ημερομηνία από μόνη της δεν είναι υπόσχεση.
  • Το actual σε ένα συμβάν είναι true για κάτι που συνέβη και false για κάτι προγραμματισμένο. Μην αντιμετωπίζετε ποτέ μια προγραμματισμένη κίνηση ως γεγονός.
  • Τα carrier_code, origin, destination και unlocode είναι null όταν ο μεταφορέας δεν έδωσε τίποτα που μπορούσαμε να αναγνωρίσουμε, αντί να μαντέψουμε.

Τα δημόσια endpoints έχουν όριο αιτημάτων ανά IP και προορίζονται για γρήγορο έλεγχο. Οτιδήποτε σε κλίμακα χαρτοφυλακίου απαιτεί κλειδί.

Αποκτήστε κλειδί API

  1. Εγγραφείτε στο trackingmcp.com.
  2. Ανοίξτε τις ρυθμίσεις προγραμματιστή και δημιουργήστε ένα κλειδί. Φέρει πρόθεμα προϊόντος, για παράδειγμα tmcp_ για την παρακολούθηση.
  3. Στείλτε το ως token bearer σε κάθε πιστοποιημένο αίτημα.
curl https://api.trackingmcp.com/v1/containers/summary \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"
{
  "ok": true,
  "data": {
    "total_active": 128,
    "exceptions": 6,
    "arriving_this_week": 14,
    "demurrage_risk_usd": 4820.5,
    "containers": []
  }
}

Ξεκινήστε την παρακολούθηση ενός φορτίου

Τα endpoints με κλειδί δέχονται δύο υποχρεωτικά πεδία, identifier και identifier_type. Ο τύπος είναι ένα από τα container_id, bill_of_lading ή booking.

curl -X POST https://api.trackingmcp.com/v1/containers \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"MEDU1234562","identifier_type":"container_id"}'
{
  "ok": true,
  "data": {
    "id": "8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef",
    "identifier": "MEDU1234562",
    "status": "in_transit",
    "carrier_code": "MSCU",
    "source": "direct_carrier"
  }
}

Κρατήστε το id. Είναι UUID, και όλα τα υπόλοιπα endpoints κοντέινερ χρησιμοποιούν αυτό ως κλειδί και όχι τον αριθμό του κοντέινερ. Ένα κοντέινερ που δεχόμαστε αλλά δεν μπορούμε να αναγνωρίσουμε με την πρώτη προσπάθεια επιστρέφει με "status": "unknown" και ένα warning, και συμπληρώνεται μέσα σε λίγα λεπτά καθώς εκτελείται η επανάληψη του ερωτήματος.

Το ίδιο κλειδί λειτουργεί σε όλη την οικογένεια προϊόντων, όπου ένα προϊόν δέχεται τα κοινά διαπιστευτήρια. Διαβάστε τον οδηγό πιστοποίησης για την πλήρη εικόνα σχετικά με τα προθέματα και τις κεφαλίδες.

Επόμενα βήματα