SDK e strumenti
Tutto ciò che serve per sviluppare su Navo24.
Specifiche OpenAPI per ogni prodotto, un client tipizzato nel tuo linguaggio con un solo comando, collection Postman pronte all'uso, server MCP per gli assistenti AI e un pulsante di test per il tuo ricevitore di webhook.
Scegli come il tuo sistema comunica con Navo24.
REST API
Chiama l'API dal tuo codice
Il tuo backend invia un container, una lettera di vettura aerea o una tratta a https://api.navo24.com/v1/<product> con una chiave bearer e riceve JSON in risposta. Usa un client generato, la collection Postman o semplice HTTP.
Leggi la guida rapidaMCP
Lascia che un assistente AI chiami gli strumenti
Claude, Cursor, ChatGPT o qualsiasi client MCP si collega a un server MCP di Navo24 e richiama tracking, orari, tariffe e pianificazione del carico come strumenti. Nessun codice client da scrivere.
Guida rapida MCPLibrerie client
Un client tipizzato nel tuo linguaggio, con un solo comando.
Ogni prodotto pubblica una specifica OpenAPI 3 che punta già a api.navo24.com. Esegui OpenAPI Generator su di essa e ottieni i modelli, una classe API per sezione e la gestione dell'autenticazione. Prima di ogni release generiamo tutti e sei i target qui sotto dalle nostre specifiche.
I pacchetti ufficiali Navo24 per npm, PyPI e gli altri registri non sono ancora pubblicati. Nel frattempo, genera il client da solo: resta allineato all'API ogni volta che lo rigeneri.
Una guida passo passo con un wrapper fetch scritto a manonpx @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-goSostituisci tracking.json con air.json, schedules.json, loading.json o rates.json per ottenere gli altri prodotti. Richiede Node.js 18+ e Java 11+; l'immagine Docker openapitools/openapi-generator-cli accetta gli stessi parametri.
OpenAPI e Postman
Specifiche e collection per ogni prodotto.
Scarica la specifica per la generazione di codice o i test di contratto, oppure importa la collection e invia la tua prima richiesta in un minuto. Imposta la variabile apiKey con la tua chiave; baseUrl è già compilata.
Bruno e Insomnia importano la stessa collection o direttamente il file OpenAPI.
Strumenti
Altri strumenti inclusi con ogni chiave.
Esempi di codice
Ogni endpoint della reference offre richieste pronte da copiare in curl, JavaScript e Python, con risposte reali.
Sfoglia la referenceServer MCP
Un server MCP per prodotto, più mcp.navo24.com per distanze, CO2e, navi e voli. La stessa chiave dell'API.
Server MCP di Navo24Invio di test dei webhook
Invia un evento di test firmato al tuo ricevitore da qualsiasi prodotto e verifica end to end header, envelope e tentativi di reinvio.
Guida ai webhookApp integrabili
Tracking, tariffe e orari sul sito di un cliente con il suo brand, con un solo tag script e una chiave vincolata al dominio.
Integra le appFeed di eventi DCSA
Eventi Track & Trace nel formato DCSA, per i sistemi che già parlano questo standard.
Feed DCSAErrori e limiti di frequenza
Un unico formato di errore per tutti i prodotti, i codici di stato da gestire e come distanziare i tentativi di reinvio.
Errori e limitiWebhooks
Testa il tuo ricevitore
Crea un webhook, poi chiedici un ping. Segue lo stesso percorso di un evento reale: stessi header, stessa firma, stessa sequenza di reinvii.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"