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"