API Keys

API Keys รหัสตัวแทนการเข้าสู่ระบบของผู้ใช้งาน เปรียบเสมือนกุญแจสำหรับ เข้าถึงข้อมูลหรือบริการที่อยู่บนระบบ ซึ่ง Vallaris Maps Platform มีความยืดหยุ่นสำหรับผู้ใช้งาน คือ สามารถกำหนดสิทธิ์ (Scope) API Key ให้เข้าถึงเฉพาะแต่ละแอปพลิเคชันหรือบริการได้ เพื่อควบคุมการเข้าถึงข้อมูลและฟังก์ชันการทำงานได้ อย่างมีประสิทธิภาพ

API Keys มักถูกใช้งานเมื่อมีการเรียกใช้ API Services ซึ่งช่วยให้นักพัฒนาซอฟต์แวร์สามารถเชื่อมต่อแอปพลิเคชันของตนกับ Vallaris Maps Platform เพื่อดึงข้อมูลและบริการต่างๆ ไปใช้งานได้อย่างสะดวก

ขั้นตอนการสร้าง API Keys

Mangement > API Keys

1. คลิกที่ปุ่ม API Keys ใหม่
2. ระบุข้อมูลสำหรับสร้าง API Key
   • กำหนดชื่อ API Keys ตามความเหมาะสมและให้สื่อความหมาย
   • เลือกประเภทข้อจำกัด (Restriction) ที่สารถใช้ API Key ในการเข้าถึงได้
     • None : ไม่มีข้อจำกัด ผู้ใช้สามารถเข้าถึง API ได้จากทุกที่
     • HTTP : จำกัดการเข้าถึง Host Server ที่กำหนด เช่น http://example.com/
     • IP Address : ระบุ IP Address ที่อนุญาตให้เข้าถึง API เช่น 142.250.189.142
3. คลิก สร้าง (Create) เพื่อสร้าง API Key

การกำหนดสิทธิ์ (Scope) API Key

Application Scope ฟังก์ชันที่ช่วยให้คุณสามารถกำหนดสิทธิ์การเข้าถึงข้อมูลและบริการต่างๆ บน Vallaris Maps Platform ให้กับ API Key ของคุณได้อย่างมีประสิทธิภาพ

วิธีเพิ่มและลบสิทธิ์ API Key

1. คลิกที่ปุ่มจุด 3 จุดของ API Key ที่ต้องแก้ไขการเข้าถึงแอปพลิเคชัน (Application Access)
2. คลิกที่ การเข้าถึงแอปพลิเคชัน (Application Access)
3. คลิกที่ ไอคอนแก้ไข (รูปดินสอ) ซึ่งจะแสดงหน้าต่าง สำหรับจัดการสิทธิ์ของ API Keys
   • **เพิ่มสิทธิ์ :**​ เลือก Dropdown และเลือกสิทธิ์ที่ต้องการเพิ่ม
   • ลบสิทธิ์ : คลิกที่ ไอคอนกากบาท ของสิทธิ์ (Scope) ที่ไม่ต้องการ
4. คลิกที่ ไอคอนรูปถังขยะ เพื่อลบแอปพลิเคชันให้ใช้ API Key ในการเข้าถึงไม่ได้
   • ลบทีละรายการ : คลิกที่ไอคอนรูปถังขยะ หน้าต่างยืนยันจะปรากฏขึ้น คลิกปุ่มลบ (Delete) เพื่อยืนยัน
   • ลบหลายรายการ : คลิกที่ช่องสี่เหลี่ยม หน้าชื่อแอปพลิเคชันหรือบริการที่ต้องการลบ หรือ เลือกทั้งหมด (Select All) เพื่อลบทั้งหมด จากนั้นคลิกที่ไอคอนรูปถังขยะ หน้าต่างยืนยันจะปรากฏขึ้น คลิกปุ่มลบ (Delete) เพื่อยืนยัน
5. คลิกที่ปุ่ม อัปเดต (Update) เพื่อบันทึกการเปลี่ยนแปลง

การตั้งค่าสิทธิ์ API Key

การตั้งค่าสิทธิ์ API Key อย่างเหมาะสม ช่วยเพิ่มความปลอดภัยและควบคุมการเข้าถึงข้อมูลบน Vallaris Maps Platform ได้อย่างมีประสิทธิภาพ

ตัวอย่างการใช้งาน API Key

• เรียกใช้ API Service สำหรับข้อมูล Geojson ที่อยู่ใน Features Collection
• เรียกข้อมูล Tile เพื่อแสดงผลบนแผนที่

**ตัวอย่างการเรียกใช้ API Service Features Collection **

https://va-cdn-02.vallarismaps.com/core/api/features/1.1/collections/667276c6563194677411bf43/items?api_key=1k8kmFR780oMHrsTG0QLWYR2efEyBdKaoomWoqDhXb8I4mu85AkU3fw6cT4S6ran

จากตัวอย่างข้างต้นจะเห็นได้ว่ามีการส่งพารามิเตอร์ด้วยคีย์ api_key เพื่อใช้สำหรับเป็นกุญแจเข้าถึงข้อมูล Features Collection