SDK et outils
Tout ce qu'il vous faut pour développer sur Navo24.
Des spécifications OpenAPI pour chaque produit, un client typé dans votre langage en une seule commande, des collections Postman prêtes à l'emploi, des serveurs MCP pour les assistants IA et un bouton de test pour votre récepteur de webhooks.
Choisissez comment votre système dialogue avec Navo24.
REST API
Appelez l'API depuis votre propre code
Votre backend envoie un conteneur, une lettre de transport aérien ou une liaison à https://api.navo24.com/v1/<product> avec une clé bearer et reçoit du JSON en retour. Utilisez un client généré, la collection Postman ou du HTTP brut.
Lire le guide de démarrageMCP
Laissez un assistant IA appeler les outils
Claude, Cursor, ChatGPT ou tout client MCP se connecte à un serveur MCP Navo24 et appelle le suivi, les horaires, les tarifs et la planification de chargement comme des outils. Aucun code client à écrire.
Démarrage rapide MCPBibliothèques clientes
Un client typé dans votre langage, en une seule commande.
Chaque produit publie une spécification OpenAPI 3 qui pointe déjà vers api.navo24.com. Lancez OpenAPI Generator dessus et vous obtenez les modèles, une classe d'API par section et la gestion de l'authentification. Nous générons les six cibles ci-dessous à partir de nos propres spécifications avant chaque version.
Les paquets officiels Navo24 pour npm, PyPI et les autres registres ne sont pas encore publiés. En attendant, générez le client vous-même : il reste synchronisé avec l'API à chaque régénération.
Un tutoriel avec un wrapper fetch écrit à la mainnpx @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-goRemplacez tracking.json par air.json, schedules.json, loading.json ou rates.json pour obtenir les autres produits. Nécessite Node.js 18+ et Java 11+ ; l'image Docker openapitools/openapi-generator-cli accepte les mêmes options.
OpenAPI et Postman
Spécifications et collections pour chaque produit.
Téléchargez la spécification pour la génération de code ou les tests de contrat, ou importez la collection et envoyez votre première requête en une minute. Renseignez votre clé dans la variable apiKey ; baseUrl est déjà configurée.
Bruno et Insomnia importent la même collection ou directement le fichier OpenAPI.
Outils
D'autres outils inclus avec chaque clé.
Exemples de code
Chaque endpoint de la référence propose des requêtes prêtes à copier en curl, JavaScript et Python, avec de vraies réponses.
Parcourir la référenceServeurs MCP
Un serveur MCP par produit, plus mcp.navo24.com pour les distances, le CO2e, les navires et les vols. La même clé que pour l'API.
Serveur MCP Navo24Envoi de test des webhooks
Envoyez un événement de test signé à votre récepteur depuis n'importe quel produit et vérifiez de bout en bout les en-têtes, l'enveloppe et les nouvelles tentatives.
Guide des webhooksApplications intégrables
Suivi, tarifs et horaires sur le site d'un client, à ses couleurs, avec une seule balise script et une clé limitée à un domaine.
Intégrer les applicationsFlux d'événements DCSA
Des événements Track & Trace au format DCSA, pour les systèmes qui parlent déjà ce standard.
Flux DCSAErreurs et limites de débit
Une enveloppe d'erreur unique pour tous les produits, les codes de statut à traiter et la façon d'espacer les nouvelles tentatives.
Erreurs et limitesWebhooks
Testez votre récepteur
Créez un webhook, puis demandez-nous un ping. Il suit le même chemin qu'un événement réel : mêmes en-têtes, même signature, même séquence de nouvelles tentatives.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"