SDK'lar ve araçlar
Navo24 üzerinde geliştirmek için ihtiyacınız olan her şey.
Her ürün için OpenAPI spesifikasyonları, tek komutla kendi dilinizde tipli bir istemci, hazır Postman koleksiyonları, yapay zeka asistanları için MCP sunucuları ve webhook alıcınız için bir test düğmesi.
Sisteminizin Navo24 ile nasıl konuşacağını seçin.
REST API
API'yi kendi kodunuzdan çağırın
Arka uç sisteminiz bir konteyneri, hava konşimentosunu veya bir hattı bearer anahtarla https://api.navo24.com/v1/<product> adresine gönderir ve JSON yanıt alır. Oluşturulmuş bir istemci, Postman koleksiyonu veya doğrudan HTTP kullanın.
Hızlı başlangıç kılavuzunu okuyunMCP
Araçları bir yapay zeka asistanı çağırsın
Claude, Cursor, ChatGPT veya herhangi bir MCP istemcisi bir Navo24 MCP sunucusuna bağlanır ve takip, sefer tarifeleri, navlun fiyatları ve yükleme planlamasını araç olarak çağırır. İstemci kodu yazmanız gerekmez.
MCP hızlı başlangıçİstemci kütüphaneleri
Tek komutla kendi dilinizde tipli bir istemci.
Her ürün, doğrudan api.navo24.com adresini gösteren bir OpenAPI 3 spesifikasyonu yayınlar. Üzerinde OpenAPI Generator çalıştırdığınızda modeller, her bölüm için bir API sınıfı ve kimlik doğrulama yönetimi elde edersiniz. Aşağıdaki altı hedefin tamamını her sürümden önce kendi spesifikasyonlarımızdan oluşturuyoruz.
npm, PyPI ve diğer kayıt depoları için resmi Navo24 paketleri henüz yayınlanmadı. Yayınlanana kadar istemciyi kendiniz oluşturun: her yeniden oluşturduğunuzda API ile uyumlu kalır.
Elle yazılmış bir fetch sarmalayıcısıyla adım adım kılavuznpx @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-goDiğer ürünler için tracking.json yerine air.json, schedules.json, loading.json veya rates.json kullanın. Node.js 18+ ve Java 11+ gerekir; openapitools/openapi-generator-cli Docker imajı aynı parametreleri kabul eder.
OpenAPI ve Postman
Her ürün için spesifikasyonlar ve koleksiyonlar.
Kod üretimi veya sözleşme testleri için spesifikasyonu indirin ya da koleksiyonu içe aktarıp ilk isteğinizi bir dakika içinde gönderin. apiKey değişkenine anahtarınızı girin; baseUrl zaten doldurulmuştur.
Bruno ve Insomnia aynı koleksiyonu veya OpenAPI dosyasını doğrudan içe aktarabilir.
Araçlar
Her anahtarla birlikte gelen diğer araçlar.
Kod örnekleri
Referanstaki her uç nokta için curl, JavaScript ve Python ile kopyalayıp yapıştırabileceğiniz istekler ve gerçek yanıtlar bulunur.
Referansa göz atınMCP sunucuları
Her ürün için bir MCP sunucusu, ayrıca mesafe, CO2e, gemiler ve uçuşlar için mcp.navo24.com. API ile aynı anahtar.
Navo24 MCP sunucusuWebhook test gönderimi
Herhangi bir üründen alıcınıza imzalı bir test olayı gönderin; başlıkları, zarfı ve yeniden denemeleri uçtan uca kontrol edin.
Webhook kılavuzuGömülebilir uygulamalar
Takip, navlun fiyatları ve sefer tarifeleri, tek bir script etiketi ve alan adına kilitli bir anahtarla müşteri sitesinde kendi markasıyla.
Uygulamaları gömünDCSA olay akışı
Standardı zaten kullanan sistemler için DCSA formatında Track & Trace olayları.
DCSA akışıHatalar ve hız sınırları
Tüm ürünlerde tek bir hata zarfı, dallanma için kullanılacak durum kodları ve yeniden denemelerin nasıl geri çekilmesi gerektiği.
Hatalar ve sınırlarWebhooks
Alıcınızı test edin
Bir webhook oluşturun, ardından bizden bir ping isteyin. Ping gerçek bir olayla aynı yolu izler: aynı başlıklar, aynı imza, aynı yeniden deneme adımları.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"