Skip to content
Navo24Navo24

SDK и инструменты

Всё, что нужно, чтобы строить на Navo24.

Спецификации OpenAPI для каждого продукта, типизированный клиент на вашем языке одной командой, готовые коллекции Postman, серверы MCP для AI-ассистентов и кнопка тестирования для приёмника вебхуков.

Выберите, как ваша система взаимодействует с Navo24.

REST API

Вызывайте API из своего кода

Ваш бэкенд отправляет контейнер, авианакладную или направление на https://api.navo24.com/v1/<product> с bearer-ключом и получает в ответ JSON. Используйте сгенерированный клиент, коллекцию Postman или обычный HTTP.

Читать quickstart

MCP

Позвольте AI-ассистенту вызывать инструменты

Claude, Cursor, ChatGPT или любой MCP-клиент подключается к MCP-серверу Navo24 и вызывает отслеживание, расписания, ставки и планирование загрузки как инструменты. Никакого клиентского кода.

Quickstart MCP

Клиентские библиотеки

Типизированный клиент на вашем языке одной командой.

Каждый продукт публикует спецификацию OpenAPI 3, которая уже указывает на api.navo24.com. Запустите по ней OpenAPI Generator и получите модели, класс API для каждого раздела и обработку аутентификации. Перед каждым релизом мы генерируем из собственных спецификаций все шесть вариантов ниже.

Официальные пакеты Navo24 для npm, PyPI и других реестров пока не опубликованы. До тех пор генерируйте клиент самостоятельно: при каждой повторной генерации он соответствует актуальному API.

Пошаговое руководство с собственной обёрткой над fetch
npx @openapitools/openapi-generator-cli generate \
  -i https://navo24.com/developers/openapi/tracking.json \
  -g typescript-fetch \
  -o ./navo24-tracking-ts

Замените tracking.json на air.json, schedules.json, loading.json или rates.json, чтобы получить остальные продукты. Нужны Node.js 18+ и Java 11+; Docker-образ openapitools/openapi-generator-cli принимает те же флаги.

OpenAPI и Postman

Спецификации и коллекции для каждого продукта.

Скачайте спецификацию для генерации кода или контрактных тестов либо импортируйте коллекцию и отправьте первый запрос за минуту. Укажите свой ключ в переменной apiKey; baseUrl уже заполнен.

Bruno и Insomnia импортируют ту же коллекцию или напрямую файл OpenAPI.

Инструменты

Дополнительные инструменты, доступные с каждым ключом.

Примеры кода

Для каждого эндпоинта в справочнике есть готовые запросы на curl, JavaScript и Python с реальными ответами.

Открыть справочник

Серверы MCP

Отдельный MCP-сервер для каждого продукта, а также mcp.navo24.com для расстояний, CO2e, судов и рейсов. Тот же ключ, что и для API.

MCP-сервер Navo24

Тестовая доставка вебхука

Отправьте подписанное тестовое событие на свой приёмник из любого продукта и проверьте заголовки, конверт и повторные попытки от начала до конца.

Руководство по вебхукам

Встраиваемые приложения

Отслеживание, ставки и расписания на сайте клиента в его собственном брендинге, с одним тегом script и ключом, привязанным к домену.

Встроить приложения

Поток событий DCSA

События Track & Trace в формате DCSA для систем, которые уже работают по этому стандарту.

Поток DCSA

Ошибки и лимиты запросов

Единый формат ошибок для всех продуктов, коды статуса для обработки и правила задержки повторных попыток.

Ошибки и лимиты

Webhooks

Протестируйте свой приёмник

Создайте вебхук, а затем попросите нас отправить ping. Он проходит тот же путь, что и реальное событие: те же заголовки, та же подпись, тот же график повторных попыток.

POST /webhooks/{id}/test
curl
curl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
  -H "Authorization: Bearer $NAVO24_API_KEY"