การส่งข้อมูลเทเลเมติกส์

หน้านี้อธิบายวิธีที่ลูกค้าหรือผู้ให้บริการข้อมูลภายนอกสามารถส่งเหตุการณ์เทเลเมติกส์เข้าสู่ Cartrack ได้อย่างถูกต้องและปลอดภัย

เหมาะสำหรับใคร

เหตุการณ์แบบ JSON ที่เป็นไปตามสคีมาใน ข้อกำหนดเหตุการณ์
ใช้เวลาแบบ UTC และรูปแบบ ISO-8601 เท่านั้น
ทุกเหตุการณ์ต้องไม่ซ้ำกัน ให้ใส่ตัวระบุระดับผู้ให้บริการที่คงที่สำหรับการป้องกันข้อมูลซ้ำ
ผู้ส่งอาจเป็นอุปกรณ์ภาคสนามที่รองรับฟอร์แมตของ Cartrack โดยตรง หรือเซิร์ฟเวอร์ตัวกลางของผู้ให้บริการที่ส่งต่อเหตุการณ์แทนอุปกรณ์

ส่งเหตุการณ์ผ่าน HTTPS ไปยังปลายทางตามภูมิภาคของคุณ:
- แอฟริกา: https://af-webhooks-prod.cartrack.com/api/data/ingest/telematics
- เอเชีย: https://as-webhooks-prod.cartrack.com/api/data/ingest/telematics
- ยุโรป: https://eu-webhooks-prod.cartrack.com/api/data/ingest/telematics
ยืนยันตัวตนด้วยเฮดเดอร์ X-API-KEY ที่ Cartrack จัดให้สำหรับเทนแนนต์ของคุณ
ส่งเหตุการณ์ JSON ครั้งละ 1 รายการต่อคำขอ (การส่งแบบ batch จะให้รายละเอียดเพิ่มเติมภายหลัง)
รหัสสถานะ HTTP จะแจ้งผลการรับ; กรณีไม่ผ่านการตรวจสอบจะมีรายละเอียดเหตุผลให้

ใส่ X-API-KEY: <your-key> ในทุกคำขอ คีย์จะออกให้สำหรับสภาพแวดล้อม staging และ production แยกกัน
เก็บรักษาคีย์เป็นความลับ หมุนเปลี่ยนทันทีเมื่อมีความเสี่ยง หรือเมื่อได้รับแจ้งจากทีม Cartrack
หากมีหลายระบบส่ง ให้ใช้คีย์แยกกันต่อระบบเพื่อให้ง่ายต่อการเพิกถอน

chassis_number (VIN) เป็นกุญแจหลักในการแมปรถระหว่างระบบ ต้องสร้างรถใน Cartrack ก่อน มิฉะนั้นเหตุการณ์จะถูกปฏิเสธ
บังคับความไม่ซ้ำของเหตุการณ์ด้วย provider_event_id หรือคอมโพสิตที่คุณกำหนด
ตรวจสอบว่า event_ts ไม่เป็นเวลาล่วงหน้า
ใช้กิโลเมตรสำหรับระยะไมล์สะสม และ km/h สำหรับความเร็ว

ดูรายละเอียดฟิลด์และตัวอย่างเพย์โหลดได้ที่ ข้อกำหนดเหตุการณ์ และอ่านเอกสารปลายทางการส่งที่ https://docs-af-webhooks-prod.cartrack.com/api/telematics-ingest#tag/Data-Ingestion