SDKとツール
Navo24で開発するためのすべてがここに.
全製品のOpenAPI仕様、コマンド1つで生成できる各言語の型付きクライアント、すぐ使えるPostmanコレクション、AIアシスタント向けMCPサーバー、そしてWebhook受信側のテストボタンをご用意しています。
システムとNavo24の連携方法を選択してください。
REST API
自社コードからAPIを呼び出す
バックエンドからコンテナ番号、航空運送状番号、または航路をBearerキー付きで https://api.navo24.com/v1/<product> に送信すると、JSONが返されます。生成したクライアント、Postmanコレクション、または通常のHTTPでご利用いただけます。
クイックスタートを読むMCP
AIアシスタントにツールを呼び出させる
Claude、Cursor、ChatGPTなどのMCPクライアントがNavo24 MCPサーバーに接続し、追跡、スケジュール、運賃、積載計画をツールとして呼び出します。クライアントコードを書く必要はありません。
MCPクイックスタートクライアントライブラリ
各言語の型付きクライアントをコマンド1つで。
各製品は、api.navo24.com を参照済みのOpenAPI 3仕様を公開しています。OpenAPI Generatorを実行するだけで、モデル、セクションごとのAPIクラス、認証処理が手に入ります。下記の6つのターゲットはすべて、リリースのたびに当社の仕様から生成して検証しています。
npm、PyPIなどのレジストリ向け公式Navo24パッケージはまだ公開していません。公開までは、ご自身でクライアントを生成してください。再生成するたびにAPIと常に同期した状態を保てます。
手書きのfetchラッパーを使ったチュートリアルnpx @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-gotracking.json を air.json、schedules.json、loading.json、rates.json に置き換えると、他の製品のクライアントを生成できます。Node.js 18以上とJava 11以上が必要です。openapitools/openapi-generator-cli のDockerイメージでも同じフラグが使えます。
OpenAPIとPostman
全製品の仕様とコレクション。
コード生成やコントラクトテスト用に仕様をダウンロードするか、コレクションをインポートして1分で最初のリクエストを送信できます。apiKey 変数にご自身のキーを設定してください。baseUrl は設定済みです。
BrunoとInsomniaでも、同じコレクションまたはOpenAPIファイルを直接インポートできます。
ツール
すべてのキーで使える、その他のツール。
コードサンプル
リファレンスの全エンドポイントに、curl、JavaScript、Pythonでそのまま使えるリクエスト例と実際のレスポンスを掲載しています。
リファレンスを見るMCPサーバー
製品ごとに1つのMCPサーバーに加え、距離、CO2e、船舶、フライト向けの mcp.navo24.com を提供。APIと同じキーで利用できます。
Navo24 MCPサーバーWebhookテスト配信
任意の製品から署名付きテストイベントを受信側に送信し、ヘッダー、エンベロープ、リトライをエンドツーエンドで確認できます。
Webhookガイド埋め込みアプリ
scriptタグ1つとドメイン制限付きキーで、追跡、運賃、スケジュールを顧客サイトに独自ブランドで表示できます。
アプリを埋め込むDCSAイベントフィード
DCSA形式のTrack & Traceイベント。この標準にすでに対応しているシステム向けです。
DCSAフィードエラーとレート制限
全製品共通のエラーエンベロープ、分岐に使うステータスコード、リトライのバックオフ方法を解説します。
エラーと制限Webhooks
受信側をテストする
Webhookを作成したら、pingを送るようリクエストしてください。実際のイベントと同じ経路で届きます。ヘッダー、署名、リトライの段階もすべて同じです。
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"