Skip to content
Navo24Navo24

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 rapida

MCP

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 MCP

Librerie 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 mano
npx @openapitools/openapi-generator-cli generate \
  -i https://navo24.com/developers/openapi/tracking.json \
  -g typescript-fetch \
  -o ./navo24-tracking-ts

Sostituisci 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.

Webhooks

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}/test
curl
curl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
  -H "Authorization: Bearer $NAVO24_API_KEY"