Skip to content
Navo24Navo24
Inizia gratis

Primi passi

Primi passi

Guida rapida all'API di tracking container: la tua prima chiamata a Navo24 in due minuti senza chiave, poi una API key e una spedizione tracciata.

Navo24 è intelligence per il trasporto merci che chiami direttamente: tracking di container e lettere di vettura aerea, orari di navigazione e affidabilità, tariffe spot e pianificazione del carico. Ogni prodotto offre una API REST, e la maggior parte anche un server MCP, tutto con un’unica chiave bearer.

Fai una chiamata senza account

Il modo più rapido per vedere dati reali è l’endpoint pubblico dell’API di tracking container. Non serve alcuna chiave.

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

Ricevi uno stato normalizzato, la nave, le milestone e una ETA che indica se è ancora una previsione:

{
  "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
      }
    ]
  }
}

Quattro campi contengono la maggior parte del significato:

  • identifier_type è ciò che abbiamo stabilito essere davvero il riferimento, che può differire da quanto ipotizzavi.
  • eta_is_estimated è true finché la ETA è una previsione, false quando diventa l’arrivo effettivo e null quando non abbiamo alcuna ETA. Una data da sola non è una promessa.
  • actual su un evento è true per qualcosa che è avvenuto e false per qualcosa di pianificato. Non considerare mai un movimento pianificato come un fatto.
  • carrier_code, origin, destination e unlocode sono null quando il vettore non ha indicato nulla che potessimo risolvere, invece di essere indovinati.

Gli endpoint pubblici hanno un limite di richieste per IP e servono per una verifica veloce. Qualsiasi uso su scala di portafoglio richiede una chiave.

Ottieni una API key

  1. Registrati su trackingmcp.com.
  2. Apri le impostazioni sviluppatore e genera una chiave. Ha un prefisso di prodotto, ad esempio tmcp_ per il tracking.
  3. Inviala come token bearer in ogni richiesta autenticata.
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": []
  }
}

Inizia a tracciare una spedizione

L’interfaccia con chiave richiede due campi obbligatori, identifier e identifier_type. Il tipo è uno tra container_id, bill_of_lading e 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"
  }
}

Conserva l’id. È un UUID, e tutti gli altri endpoint dei container si basano su di esso anziché sul numero del container. Un container che accettiamo ma non riusciamo a risolvere al primo passaggio torna con "status": "unknown" e un warning, e si completa entro pochi minuti man mano che viene eseguita la nuova interrogazione.

La stessa chiave funziona in tutta la famiglia di prodotti, quando un prodotto accetta la credenziale comune. Leggi la guida all’autenticazione per il quadro completo su prefissi e header.

Prossimi passi