SDK y herramientas
Todo lo que necesitas para desarrollar sobre Navo24.
Especificaciones OpenAPI para cada producto, un cliente tipado en tu lenguaje con un solo comando, colecciones de Postman listas para usar, servidores MCP para asistentes de IA y un botón de prueba para tu receptor de webhooks.
Elige cómo se comunica tu sistema con Navo24.
REST API
Llama a la API desde tu propio código
Tu backend envía un contenedor, una guía aérea o una ruta a https://api.navo24.com/v1/<product> con una clave bearer y recibe JSON. Usa un cliente generado, la colección de Postman o HTTP directo.
Leer la guía de inicio rápidoMCP
Deja que un asistente de IA use las herramientas
Claude, Cursor, ChatGPT o cualquier cliente MCP se conecta a un servidor MCP de Navo24 y usa el seguimiento, los itinerarios, las tarifas y la planificación de carga como herramientas. Sin escribir código de cliente.
Inicio rápido con MCPBibliotecas cliente
Un cliente tipado en tu lenguaje, con un solo comando.
Cada producto publica una especificación OpenAPI 3 que ya apunta a api.navo24.com. Ejecuta OpenAPI Generator sobre ella y obtendrás modelos, una clase de API por sección y la gestión de autenticación. Generamos los seis destinos de abajo a partir de nuestras propias especificaciones antes de cada versión.
Los paquetes oficiales de Navo24 para npm, PyPI y otros registros aún no están publicados. Mientras tanto, genera el cliente tú mismo: se mantiene alineado con la API cada vez que lo regeneras.
Una guía paso a paso con un wrapper de fetch escrito 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-goCambia tracking.json por air.json, schedules.json, loading.json o rates.json para obtener los demás productos. Requiere Node.js 18+ y Java 11+; la imagen Docker openapitools/openapi-generator-cli acepta los mismos parámetros.
OpenAPI y Postman
Especificaciones y colecciones para cada producto.
Descarga la especificación para generar código o hacer pruebas de contrato, o importa la colección y envía tu primera petición en un minuto. Asigna tu clave a la variable apiKey; baseUrl ya viene configurada.
| Producto | Especificación OpenAPI | Colección de Postman | Operaciones |
|---|---|---|---|
| TrackingMCP | tracking.json | tracking.postman_collection.json | 18 |
| AirCargoMCP | air.json | air.postman_collection.json | 7 |
| SchedulesMCP | schedules.json | schedules.postman_collection.json | 8 |
| LoadingMCP | loading.json | loading.postman_collection.json | 1 |
| FreightRatesMCP | rates.json | rates.postman_collection.json | 9 |
Bruno e Insomnia importan la misma colección o directamente el archivo OpenAPI.
Herramientas
Más herramientas incluidas con cada clave.
Ejemplos de código
Cada endpoint de la referencia incluye peticiones listas para copiar en curl, JavaScript y Python, con respuestas reales.
Ver la referenciaServidores MCP
Un servidor MCP por producto, además de mcp.navo24.com para distancias, CO2e, buques y vuelos. La misma clave que la API.
Servidor MCP de Navo24Envío de prueba de webhooks
Envía un evento de prueba firmado a tu receptor desde cualquier producto y comprueba de principio a fin las cabeceras, el sobre y los reintentos.
Guía de webhooksAplicaciones integrables
Seguimiento, tarifas e itinerarios en el sitio de un cliente con su propia marca, con una sola etiqueta script y una clave restringida por dominio.
Integrar las aplicacionesFeed de eventos DCSA
Eventos de Track & Trace con el formato DCSA, para sistemas que ya hablan el estándar.
Feed DCSAErrores y límites de uso
Un único sobre de error para todos los productos, los códigos de estado a tener en cuenta y cómo espaciar los reintentos.
Errores y límitesWebhooks
Prueba tu receptor
Crea un webhook y pídenos un ping. Sigue el mismo camino que un evento real: mismas cabeceras, misma firma, misma secuencia de reintentos.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"