การยืนยันตัวตน

ทุกคำขอที่ส่งไปยัง WeTrust GPS API ต้องแนบ API Key (user_api_hash) เพื่อยืนยันตัวตน

วิธีขอ API Key

การขอ API Key ทำได้โดยติดต่อทีมงานผ่าน LINE Official Account: @wetrust

1. เพิ่มเพื่อน LINE OA @wetrust
2. แจ้งความประสงค์ขอใช้งาน WeTrust GPS API พร้อมข้อมูลต่อไปนี้
   • ชื่อบริษัท / ชื่อผู้ติดต่อ
   • อีเมลที่ต้องการให้จัดส่ง API Key
   • ลักษณะการใช้งานโดยสังเขป
3. ทีมงานจะตรวจสอบและ จัดส่ง API Key ให้ทางอีเมล ที่แจ้งไว้

:::info ระยะเวลาดำเนินการ โดยทั่วไปทีมงานจะติดต่อกลับและจัดส่ง API Key ภายใน 1–2 วันทำการ :::

:::warning ข้อควรระวัง เก็บ API Key ที่ได้รับทางอีเมลไว้ในที่ปลอดภัย ห้ามเปิดเผยคีย์ในโค้ดฝั่ง client หรือ repository สาธารณะ หากคีย์รั่วไหลหรือทำหาย กรุณาติดต่อทีมงานผ่าน LINE OA @wetrust เพื่อออกคีย์ใหม่ :::

การเปลี่ยนรหัสผ่านกับ API Key

user_api_hash ผูกกับรหัสผ่านของบัญชี เมื่อคุณเปลี่ยนรหัสผ่านในระบบ ระบบจะสร้าง user_api_hash ขึ้นใหม่ (recycle) โดยอัตโนมัติ ทำให้คีย์เดิมใช้งานไม่ได้ทันที

:::danger เปลี่ยนรหัสผ่าน = ต้องขอ API Key ใหม่ หากมีการเปลี่ยนรหัสผ่านของบัญชี คีย์เดิมจะถูกยกเลิกและทุกคำขอที่ใช้คีย์เดิมจะได้รับ 401 Unauthorized กรุณาติดต่อทีมงานผ่าน LINE OA @wetrust เพื่อขอ API Key ใหม่ทุกครั้งหลังเปลี่ยนรหัสผ่าน :::

การใช้งาน API Key

แนบคีย์ไปกับ Query Parameter user_api_hash ในทุกคำขอ พร้อมพารามิเตอร์ lang (ภาษาของผลลัพธ์)

curl "https://lite.wetrustgps.com/api/get_devices?lang=th&user_api_hash=YOUR_API_HASH"

พารามิเตอร์	จำเป็น	คำอธิบาย
user_api_hash	✅	API Key ที่ได้รับจากทีมงาน
lang	✅	ภาษาของข้อความในผลลัพธ์ เช่น th, en

:::danger เก็บ API Key เป็นความลับ user_api_hash จะปรากฏใน URL โปรดเรียกใช้งานผ่านฝั่งเซิร์ฟเวอร์เท่านั้น หลีกเลี่ยงการฝังคีย์ในเว็บฝั่งผู้ใช้ (client) หรือแอปที่ผู้อื่นเข้าถึง URL ได้ :::

รหัสสถานะที่เกี่ยวข้อง

สถานะ	ความหมาย
200 OK	ยืนยันตัวตนสำเร็จ
401 Unauthorized	ไม่ได้แนบ user_api_hash หรือคีย์ไม่ถูกต้อง
403 Forbidden	คีย์ถูกต้องแต่ไม่มีสิทธิ์เข้าถึงทรัพยากรนี้
429 Too Many Requests	เรียกใช้เกินอัตราที่กำหนด (rate limit)