เริ่มต้นใช้งาน
ยินดีต้อนรับสู่เอกสารสำหรับนักพัฒนา WeTrust GPS API — บริการ REST API สำหรับติดตามตำแหน่งและสถานะของอุปกรณ์ GPS แบบเรียลไทม์
เอกสารชุดนี้อธิบายวิธีเชื่อมต่อ ยืนยันตัวตน และเรียกใช้งาน Endpoint ต่าง ๆ ของระบบ
ภาพรวม
| หัวข้อ | รายละเอียด |
|---|---|
| Base URL | https://lite.wetrustgps.com/api |
| โปรโตคอล | HTTPS |
| รูปแบบข้อมูล | JSON |
| เมธอด | GET |
| การยืนยันตัวตน | Query Parameter user_api_hash (ดู การยืนยันตัวตน) |
เริ่มต้นใน 3 ขั้นตอน
- ขอ API Key ผ่าน LINE OA @wetrust (ทีมงานส่งให้ทางอีเมล)
- แนบ
user_api_hashไปกับทุกคำขอ พร้อมพารามิเตอร์lang - เรียกใช้ Endpoint ที่ต้องการ (ดูรายการด้านล่าง)
ทดสอบอย่างรวดเร็ว
curl "https://lite.wetrustgps.com/api/get_devices?lang=th&user_api_hash=YOUR_API_HASH"
หากได้รับสถานะ 200 OK พร้อมรายการอุปกรณ์ แสดงว่าการเชื่อมต่อและ API Key ของคุณใช้งานได้ถูกต้อง
Endpoint ทั้งหมด
| เมธอด | Endpoint | คำอธิบาย |
|---|---|---|
GET | /get_devices | ดึงรายการอุปกรณ์ทั้งหมดพร้อมตำแหน่งและสถานะล่าสุด |
GET | /get_devices_latest | ดึงเฉพาะอุปกรณ์ที่ข้อมูลเปลี่ยนแปลง (สำหรับ polling แบบเรียลไทม์) |
GET | /get_geofences | ดึงรายการพื้นที่ (geofence) ที่ลูกค้ากำหนดไว้ |
ข้อตกลงทั่วไป
- ทุกคำขอต้องส่งผ่าน HTTPS และแนบพารามิเตอร์
user_api_hashกับlangเสมอ - เวลา (timestamp) ในผลลัพธ์เป็น Unix timestamp (วินาที) ส่วนฟิลด์
timeแบบข้อความใช้รูปแบบdd-mm-yyyy HH:MM:SS - พิกัด ใช้ระบบ WGS84 โดย
latคือละติจูด และlngคือลองจิจูด - บาง Endpoint ส่งฟิลด์ที่ซับซ้อน (เช่น
sensors,tail,coordinates) มาเป็น สตริง JSON ซึ่งต้องแปลง (parse) อีกครั้งก่อนใช้งาน — ดูหมายเหตุในแต่ละ Endpoint