Quick Start

tip

เริ่มลองเรียก API เพื่อดึงรายการรถได้ทันที ที่นี่

การเริ่มต้นใช้ Cartrack Fleet API ทำได้ไม่ซับซ้อน ส่วนนี้คือวิธีตัวอย่างสำหรับเรียก API ครั้งแรก แม้จะใช้ curl เป็นตัวอย่างหลัก คุณสามารถปรับหลักการเดียวกันไปใช้กับภาษาอื่นหรือ HTTP client ใดก็ได้

สิ่งที่ต้องมี

ก่อนเริ่ม ให้ตรวจสอบว่าคุณมี:

• ติดตั้ง cURL แล้ว: โดยทั่วไปมีใน Unix, Linux, macOS และติดตั้งเพิ่มได้บน Windows
• Base URL และข้อมูลรับรอง: ต้องมี Base URL ของ Cartrack Fleet API และข้อมูลรับรองที่ถูกต้อง ดูวิธีขอรับได้ที่ส่วน Authentication และ Base URLs

การเรียก API

ตัวอย่างเรียกรายการรถด้วย curl:

curl --location '{baseUrl}/rest/vehicles' \
--header 'Accept: application/json' \
--header 'Authorization: Basic your_encoded_credentials'

แทน {baseUrl} ด้วย Base URL จริงของ Fleet API และแทน your_encoded_credentials ด้วยค่า Base64 ของข้อมูลรับรอง

อธิบายคำสั่ง

• --location: ให้ curl ตาม redirect ที่เซิร์ฟเวอร์ส่งมา
• --header: ใส่เฮดเดอร์เพิ่มเติม ตัวอย่างนี้ระบุรับ JSON และแนบข้อมูลยืนยันตัวตน
• URL {baseUrl}/rest/vehicles คือปลายทางสำหรับดึงรายการรถ

ผลลัพธ์

API จะตอบกลับเป็น JSON มีรายการรถพร้อมรายละเอียด เช่น vehicle ID รุ่น และข้อมูลที่เกี่ยวข้อง

ตัวอย่างนี้คือกรอบเริ่มต้นสำหรับเรียก Cartrack Fleet API คุณสามารถปรับให้เข้ากับภาษา/เครื่องมือที่ใช้ได้ตามหลักการเดียวกัน หากต้องการรายละเอียดฟังก์ชันและเอ็นด์พอยต์อื่น ๆ อ่านเอกสาร API ต่อได้

นำเข้า Postman

คุณสามารถนำเข้า Cartrack OpenAPI spec ลง Postman เพื่อสร้างคอลเลกชันคำขอพร้อมใช้งาน

• URL สเปก: https://developer.cartrack.com/openapi/openapi.yaml
• ใน Postman: กด Import → Link วาง URL แล้วกด Import หรือใช้ Import → File อัปโหลด openapi.yaml
• Postman จะสร้างคอลเลกชันตามสเปก
• ตั้งค่า environment:
  • กำหนด base URL ตามคู่มือในหน้า Base URLs
  • ตั้งค่าการยืนยันตัวตน: Cartrack API ใช้ Basic Authentication เปิดคำขอใดก็ได้ ไปที่แท็บ Authorization เลือก Basic Auth แล้วใส่ username/password หรือเพิ่มเฮดเดอร์ Authorization: Basic <base64-encoded-credentials> ดูรายละเอียดการสร้างข้อมูลรับรองได้ที่ Authentication
• เรียกทีละคำขอหรือใช้ Collection Runner เพื่อรันหลายคำขอได้