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"