User Token ใช้สำหรับผูกข้อมูลกิจการ (Merchant) เข้ากับ Client User เพื่อจัดการเอกสารผ่าน API โดย Client User หนึ่งรายสามารถจัดการหลายกิจการได้ด้วย User Token ที่แตกต่างกัน
User Token คืออะไร?
User Token เป็น Token ที่ทำหน้าที่เชื่อมโยงข้อมูล 3 ส่วนเข้าด้วยกัน:
- กิจการ (Merchant) — กิจการที่ต้องการสร้างเอกสารผ่าน API
- Client User — ผู้ที่ทำหน้าที่คล้าย Provider คอยจัดการข้อมูลให้กิจการผ่าน API
- User ในกิจการ — ผู้ใช้งานคนหนึ่งในกิจการที่ผูกกับ Token นั้น
Client User หนึ่งรายสามารถถือ User Token หลายตัว เพื่อจัดการหลายกิจการผ่าน API ได้พร้อมกัน
User Token ใช้ทำอะไรบ้าง?
| การใช้งาน | รายละเอียด |
|---|---|
| ผูกข้อมูลกิจการ | ระบุว่า API request นี้ทำงานกับกิจการใด |
| ตรวจสอบสิทธิ์ (Permission) | ตรวจสอบว่า User ที่ผูกกับ Token มีสิทธิ์ดำเนินการหรือไม่ |
| บันทึก Log | ลงบันทึกว่า User คนใดเป็นผู้สร้างหรือจัดการเอกสาร |
วิธีรับ User Token
ขั้นตอนที่ 1: Client User มอบ Application Code
Client User จะเป็นผู้สร้าง Application Code และมอบให้กับ User ของกิจการที่ต้องการเชื่อมต่อ
ขั้นตอนที่ 2: User นำ Application Code ไปใส่ในโปรแกรม PEAK
User ของกิจการนำ Application Code ที่ได้รับไปกรอกในโปรแกรม PEAK ที่ หน้าตั้งค่าเชื่อมต่อแอปพลิเคชันภายนอก

ขั้นตอนที่ 3: ยืนยันการเชื่อมต่อ
ระบบจะแสดงหน้า Consent ขึ้นมาเพื่อขออนุญาตเชื่อมต่อ User กดยืนยันเพื่อยอมรับการเชื่อมต่อ
ขั้นตอนที่ 4: ระบบสร้าง User Token
หลังจากยืนยันเรียบร้อย ระบบจะสร้าง User Token ให้โดยอัตโนมัติ นำ Token นี้ไปใช้ในการเรียก API ได้ทันที
