SDK 与工具
一切就绪,助您在 Navo24 上构建.
每个产品都提供 OpenAPI 规范,一条命令即可生成您所用语言的强类型客户端,另有现成的 Postman 集合、面向 AI 助手的 MCP 服务器,以及用于测试 Webhook 接收端的测试按钮。
选择您的系统与 Navo24 的对接方式。
客户端库
一条命令,生成您所用语言的强类型客户端。
每个产品都发布一份 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-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-go将 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 使用同一密钥。
Navo24 MCP 服务器Webhook 测试推送
从任一产品向您的接收端发送带签名的测试事件,端到端检查请求头、消息封装和重试。
Webhook 指南可嵌入应用
只需一个 script 标签和一个绑定域名的密钥,即可在客户网站上以其自有品牌展示货物追踪、运价和船期。
嵌入应用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"