SDK và công cụ
Mọi thứ bạn cần để xây dựng trên Navo24.
Đặc tả OpenAPI cho mọi sản phẩm, client có kiểu dữ liệu bằng ngôn ngữ của bạn chỉ với một lệnh, bộ sưu tập Postman dùng ngay, máy chủ MCP cho trợ lý AI và nút kiểm thử cho bộ nhận webhook của bạn.
Chọn cách hệ thống của bạn giao tiếp với Navo24.
REST API
Gọi API từ mã của bạn
Backend của bạn gửi số container, vận đơn hàng không hoặc tuyến đường đến https://api.navo24.com/v1/<product> kèm khóa bearer và nhận lại JSON. Dùng client được tạo sẵn, bộ sưu tập Postman hoặc HTTP thuần.
Đọc hướng dẫn bắt đầu nhanhMCP
Để trợ lý AI gọi các công cụ
Claude, Cursor, ChatGPT hoặc bất kỳ client MCP nào kết nối với máy chủ MCP của Navo24 và gọi theo dõi, lịch trình, cước phí và lập kế hoạch xếp hàng như các công cụ. Không cần viết mã client.
Bắt đầu nhanh với MCPThư viện client
Client có kiểu dữ liệu bằng ngôn ngữ của bạn, chỉ với một lệnh.
Mỗi sản phẩm công bố một đặc tả OpenAPI 3 đã trỏ sẵn đến api.navo24.com. Chạy OpenAPI Generator với đặc tả đó, bạn sẽ có các model, một lớp API cho mỗi phần và cơ chế xác thực. Chúng tôi tự tạo cả sáu đích bên dưới từ đặc tả của mình trước mỗi bản phát hành.
Các gói Navo24 chính thức cho npm, PyPI và các registry khác chưa được phát hành. Trong thời gian chờ, hãy tự tạo client: mỗi lần tạo lại, client luôn đồng bộ với API.
Hướng dẫn chi tiết với một fetch wrapper tự viếtnpx @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-goThay tracking.json bằng air.json, schedules.json, loading.json hoặc rates.json để có client cho các sản phẩm khác. Cần Node.js 18+ và Java 11+; image Docker openapitools/openapi-generator-cli dùng cùng các cờ.
OpenAPI và Postman
Đặc tả và bộ sưu tập cho mọi sản phẩm.
Tải đặc tả về để sinh mã hoặc kiểm thử hợp đồng, hoặc nhập bộ sưu tập và gửi yêu cầu đầu tiên trong một phút. Đặt biến apiKey thành khóa của bạn; baseUrl đã được điền sẵn.
Bruno và Insomnia có thể nhập trực tiếp cùng bộ sưu tập này hoặc tệp OpenAPI.
Công cụ
Thêm nhiều công cụ đi kèm với mọi khóa.
Mã mẫu
Mọi endpoint trong tài liệu tham khảo đều có yêu cầu sẵn để sao chép bằng curl, JavaScript và Python, kèm phản hồi thực tế.
Xem tài liệu tham khảoMáy chủ MCP
Mỗi sản phẩm có một máy chủ MCP, cùng với mcp.navo24.com cho khoảng cách, CO2e, tàu và chuyến bay. Dùng chung khóa với API.
Máy chủ MCP của Navo24Gửi thử webhook
Gửi một sự kiện thử nghiệm có chữ ký đến bộ nhận của bạn từ bất kỳ sản phẩm nào và kiểm tra header, envelope và cơ chế thử lại từ đầu đến cuối.
Hướng dẫn webhookỨng dụng nhúng
Hiển thị theo dõi, cước phí và lịch trình trên website của khách hàng với thương hiệu riêng, chỉ cần một thẻ script và một khóa giới hạn theo tên miền.
Nhúng ứng dụngLuồng sự kiện DCSA
Sự kiện Track & Trace theo định dạng DCSA, dành cho các hệ thống đã hỗ trợ tiêu chuẩn này.
Luồng DCSALỗi và giới hạn tần suất
Một envelope lỗi thống nhất cho mọi sản phẩm, các mã trạng thái cần xử lý và cách giãn thời gian giữa các lần thử lại.
Lỗi và giới hạnWebhooks
Kiểm thử bộ nhận của bạn
Tạo webhook, sau đó yêu cầu chúng tôi gửi ping. Ping đi qua đúng đường dẫn như một sự kiện thật: cùng header, cùng chữ ký, cùng chuỗi thử lại.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"