Skip to content
Navo24Navo24
Commencer gratuitement

Premiers pas

Premiers pas

Démarrage rapide de l'API de suivi de conteneurs : votre premier appel Navo24 en deux minutes sans clé, puis une clé API et une expédition suivie.

Navo24, c’est de l’intelligence fret que vous appelez directement : suivi des conteneurs et des lettres de transport aérien, horaires de navigation et fiabilité, tarifs spot et planification du chargement. Chaque produit propose une API REST, et la plupart également un serveur MCP, le tout derrière une seule clé bearer.

Faire un appel sans compte

Le moyen le plus rapide de voir des données réelles est l’endpoint public de l’API de suivi de conteneurs. Aucune clé n’est nécessaire.

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

Vous recevez un statut normalisé, le navire, les étapes clés et une ETA qui indique s’il s’agit encore d’une prévision :

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

Quatre champs portent l’essentiel de l’information :

  • identifier_type indique ce que nous avons déterminé que la référence est réellement, ce qui peut différer de votre hypothèse.
  • eta_is_estimated vaut true tant que l’ETA est une prévision, false dès qu’il s’agit de l’arrivée réelle, et null lorsque nous ne disposons d’aucune ETA. Une date seule n’est pas une promesse.
  • actual sur un événement vaut true pour ce qui s’est produit et false pour ce qui est prévu. Ne considérez jamais un mouvement prévu comme un fait.
  • carrier_code, origin, destination et unlocode valent null lorsque le transporteur n’a rien indiqué que nous puissions résoudre, plutôt que d’être devinés.

Les endpoints publics sont limités en débit par IP et servent à une vérification rapide. Tout usage à l’échelle d’un portefeuille nécessite une clé.

Obtenir une clé API

  1. Inscrivez-vous sur trackingmcp.com.
  2. Ouvrez les paramètres développeur et générez une clé. Elle porte un préfixe produit, par exemple tmcp_ pour le suivi.
  3. Envoyez-la comme jeton bearer dans chaque requête authentifiée.
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": []
  }
}

Commencer à suivre une expédition

L’interface avec clé attend deux champs obligatoires, identifier et identifier_type. Le type est l’un de container_id, bill_of_lading ou 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"
  }
}

Conservez l’id. C’est un UUID, et tous les autres endpoints de conteneurs s’appuient sur lui plutôt que sur le numéro de conteneur. Un conteneur que nous acceptons sans pouvoir le résoudre au premier passage est renvoyé avec "status": "unknown" et un warning, puis se complète en quelques minutes à mesure que la nouvelle interrogation s’exécute.

La même clé fonctionne sur toute la gamme lorsqu’un produit accepte l’identifiant commun. Consultez le guide d’authentification pour tout savoir sur les préfixes et les en-têtes.

Et ensuite