Skip to content
Navo24Navo24

SDK และเครื่องมือ

ทุกสิ่งที่คุณต้องใช้เพื่อพัฒนาบน Navo24.

สเปก OpenAPI สำหรับทุกผลิตภัณฑ์ ไคลเอนต์แบบมีไทป์ในภาษาของคุณด้วยคำสั่งเดียว คอลเลกชัน Postman พร้อมใช้ เซิร์ฟเวอร์ MCP สำหรับผู้ช่วย AI และปุ่มทดสอบสำหรับตัวรับเว็บฮุกของคุณ

เลือกวิธีที่ระบบของคุณสื่อสารกับ Navo24

REST API

เรียก API จากโค้ดของคุณเอง

แบ็กเอนด์ของคุณส่งหมายเลขตู้คอนเทนเนอร์ ใบตราส่งสินค้าทางอากาศ หรือเส้นทาง ไปยัง https://api.navo24.com/v1/<product> พร้อมคีย์ Bearer และได้รับ JSON กลับมา ใช้ไคลเอนต์ที่สร้างขึ้น คอลเลกชัน Postman หรือ HTTP ธรรมดาก็ได้

อ่านคู่มือเริ่มต้นใช้งาน

MCP

ให้ผู้ช่วย AI เรียกใช้เครื่องมือ

Claude, Cursor, ChatGPT หรือไคลเอนต์ MCP ใดก็ได้ เชื่อมต่อกับเซิร์ฟเวอร์ MCP ของ Navo24 และเรียกใช้การติดตาม ตารางเดินเรือ ค่าขนส่ง และการวางแผนการบรรทุกเป็นเครื่องมือ โดยไม่ต้องเขียนโค้ดไคลเอนต์

เริ่มต้นใช้งาน MCP

ไลบรารีไคลเอนต์

ไคลเอนต์แบบมีไทป์ในภาษาของคุณ ด้วยคำสั่งเดียว

แต่ละผลิตภัณฑ์เผยแพร่สเปก OpenAPI 3 ที่ชี้ไปยัง api.navo24.com อยู่แล้ว เพียงรัน OpenAPI Generator กับสเปกนั้น คุณจะได้โมเดล คลาส API แยกตามหมวด และการจัดการการยืนยันตัวตน เราสร้างไคลเอนต์ทั้งหกเป้าหมายด้านล่างจากสเปกของเราเองก่อนทุกการเปิดตัว

แพ็กเกจ Navo24 อย่างเป็นทางการสำหรับ npm, PyPI และรีจิสทรีอื่นๆ ยังไม่ได้เผยแพร่ ระหว่างนี้ให้สร้างไคลเอนต์ด้วยตัวเอง ซึ่งจะสอดคล้องกับ API เสมอทุกครั้งที่สร้างใหม่

คู่มือทีละขั้นตอนด้วย fetch wrapper ที่เขียนเอง
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 ได้โดยตรง

เครื่องมือ

เครื่องมือเพิ่มเติมที่มาพร้อมกับทุกคีย์

ตัวอย่างโค้ด

ทุกเอนด์พอยต์ในเอกสารอ้างอิงมีคำขอพร้อมคัดลอกไปใช้ใน curl, JavaScript และ Python พร้อมการตอบกลับจริง

ดูเอกสารอ้างอิง

เซิร์ฟเวอร์ MCP

เซิร์ฟเวอร์ MCP หนึ่งตัวต่อผลิตภัณฑ์ พร้อม mcp.navo24.com สำหรับระยะทาง CO2e เรือ และเที่ยวบิน ใช้คีย์เดียวกับ API

เซิร์ฟเวอร์ MCP ของ Navo24

การส่งทดสอบเว็บฮุก

ส่งอีเวนต์ทดสอบที่มีลายเซ็นไปยังตัวรับของคุณจากผลิตภัณฑ์ใดก็ได้ และตรวจสอบเฮดเดอร์ เอนเวโลป และการส่งซ้ำได้ครบทุกขั้นตอน

คู่มือเว็บฮุก

แอปแบบฝังได้

แสดงการติดตาม ค่าขนส่ง และตารางเดินเรือบนเว็บไซต์ลูกค้าภายใต้แบรนด์ของลูกค้าเอง ด้วยแท็ก script เดียวและคีย์ที่ล็อกโดเมน

ฝังแอป

ฟีดอีเวนต์ DCSA

อีเวนต์ Track & Trace ในรูปแบบ DCSA สำหรับระบบที่รองรับมาตรฐานนี้อยู่แล้ว

ฟีด DCSA

ข้อผิดพลาดและขีดจำกัดอัตรา

เอนเวโลปข้อผิดพลาดแบบเดียวกันทุกผลิตภัณฑ์ รหัสสถานะที่ใช้แยกการทำงาน และวิธีหน่วงเวลาก่อนส่งซ้ำ

ข้อผิดพลาดและขีดจำกัด

Webhooks

ทดสอบตัวรับของคุณ

สร้างเว็บฮุก แล้วขอให้เราส่ง ping มา ซึ่งจะเดินทางผ่านเส้นทางเดียวกับอีเวนต์จริง ทั้งเฮดเดอร์ ลายเซ็น และลำดับการส่งซ้ำเหมือนกันทุกอย่าง

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