Skip to content
Navo24Navo24

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-ts

tracking.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ファイルを直接インポートできます。

ツール

すべてのキーで使える、その他のツール。

Webhooks

受信側をテストする

Webhookを作成したら、pingを送るようリクエストしてください。実際のイベントと同じ経路で届きます。ヘッダー、署名、リトライの段階もすべて同じです。

POST /webhooks/{id}/test
curl
curl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
  -H "Authorization: Bearer $NAVO24_API_KEY"