SDK и инструменты
Всё, что нужно, чтобы строить на Navo24.
Спецификации OpenAPI для каждого продукта, типизированный клиент на вашем языке одной командой, готовые коллекции Postman, серверы MCP для AI-ассистентов и кнопка тестирования для приёмника вебхуков.
Выберите, как ваша система взаимодействует с Navo24.
REST API
Вызывайте API из своего кода
Ваш бэкенд отправляет контейнер, авианакладную или направление на https://api.navo24.com/v1/<product> с bearer-ключом и получает в ответ JSON. Используйте сгенерированный клиент, коллекцию Postman или обычный HTTP.
Читать quickstartMCP
Позвольте AI-ассистенту вызывать инструменты
Claude, Cursor, ChatGPT или любой MCP-клиент подключается к MCP-серверу Navo24 и вызывает отслеживание, расписания, ставки и планирование загрузки как инструменты. Никакого клиентского кода.
Quickstart MCPКлиентские библиотеки
Типизированный клиент на вашем языке одной командой.
Каждый продукт публикует спецификацию OpenAPI 3, которая уже указывает на api.navo24.com. Запустите по ней OpenAPI Generator и получите модели, класс API для каждого раздела и обработку аутентификации. Перед каждым релизом мы генерируем из собственных спецификаций все шесть вариантов ниже.
Официальные пакеты Navo24 для npm, PyPI и других реестров пока не опубликованы. До тех пор генерируйте клиент самостоятельно: при каждой повторной генерации он соответствует актуальному API.
Пошаговое руководство с собственной обёрткой над fetchnpx @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-goЗамените 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}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"