Skip to content
Navo24Navo24

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 nhanh

MCP

Để 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 MCP

Thư 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ết
npx @openapitools/openapi-generator-cli generate \
  -i https://navo24.com/developers/openapi/tracking.json \
  -g typescript-fetch \
  -o ./navo24-tracking-ts

Thay 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.

Webhooks

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}/test
curl
curl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
  -H "Authorization: Bearer $NAVO24_API_KEY"