Skip to content
Navo24Navo24

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ápido

MCP

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 MCP

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

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

Bruno e Insomnia importan la misma colección o directamente el archivo OpenAPI.

Herramientas

Más herramientas incluidas con cada clave.

Webhooks

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