Skip to content
Navo24Navo24

SDK 与工具

一切就绪,助您在 Navo24 上构建.

每个产品都提供 OpenAPI 规范,一条命令即可生成您所用语言的强类型客户端,另有现成的 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 快速入门

客户端库

一条命令,生成您所用语言的强类型客户端。

每个产品都发布一份 OpenAPI 3 规范,并已指向 api.navo24.com。对其运行 OpenAPI Generator,即可获得数据模型、每个模块对应的 API 类以及认证处理。每次发布前,我们都会基于自己的规范生成以下全部六种目标语言的客户端。

面向 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+;Docker 镜像 openapitools/openapi-generator-cli 支持相同的参数。

OpenAPI 与 Postman

每个产品的规范与集合。

下载规范用于代码生成或契约测试,或导入集合并在一分钟内发出第一个请求。将 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"