# ใช้การเข้าถึง API

> สร้างโทเค็นการเข้าถึงส่วนบุคคลสำหรับสคริปต์และไคลเอนต์ MCP และส่งเหตุการณ์ใน Livespace ไปยังระบบของคุณเองด้วยเว็บฮุก

ใน การตั้งค่า › **การเข้าถึง API** คุณสามารถสร้างโทเค็นการเข้าถึงส่วนบุคคลเพื่อให้สคริปต์หรือไคลเอนต์ MCP ใช้ Dvina ในนามของคุณได้ ผู้ดูแลระบบยังเพิ่มเว็บฮุกได้ที่นี่ เพื่อส่งเหตุการณ์ใน Livespace ไปยังระบบของตนเอง

การเข้าถึง API มีให้ในแผน Enterprise สมาชิกทุกคนสร้างโทเค็นของตนเองได้ ส่วน **เว็บฮุก** จะมองเห็นได้เฉพาะเจ้าของและผู้ดูแลระบบเท่านั้น

## สร้างโทเค็น

1. เปิดการตั้งค่า แล้วเลือก **การเข้าถึง API**
2. ในส่วน **โทเค็นการเข้าถึงส่วนบุคคล** เลือก **สร้างโทเค็น**
3. ป้อน **ชื่อ** เพื่อให้คุณทราบในภายหลังว่าโทเค็นนี้ใช้กับอะไร
4. เลือก **สิทธิ์การเข้าถึง**: **อ่านอย่างเดียว** หรือ **อ่านและเขียน**
5. เลือกเวลาที่โทเค็น **หมดอายุ**: **ใน 30 วัน**, **ใน 90 วัน**, **ใน 365 วัน** หรือ **ไม่มีวันหมดอายุ**
6. เลือก **สร้างโทเค็น**
7. ในส่วน **คัดลอกโทเค็นของคุณ** ให้คัดลอกโทเค็นและเก็บไว้ในที่ปลอดภัย โทเค็นจะแสดงให้เห็นครั้งนี้ครั้งเดียวเท่านั้น

โทเค็นทำงานในนามของคุณใน Livespace ที่คุณสร้างโทเค็นนั้น โดยใช้บทบาทปัจจุบันของคุณใน Livespace นั้น โทเค็นแบบ **อ่านอย่างเดียว** อ่านข้อมูลได้ แต่เพิ่มหรือเปลี่ยนแปลงอะไรไม่ได้

หากต้องการใช้โทเค็นกับไคลเอนต์ MCP โปรดดู [เชื่อมต่อด้วยคีย์ API แทน OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth)

## ตรวจสอบ เปลี่ยน หรือเพิกถอนโทเค็น

โทเค็นของคุณจะแสดงอยู่ในส่วน **โทเค็นการเข้าถึงส่วนบุคคล** พร้อมสิทธิ์การเข้าถึง เลือกโทเค็นเพื่อดูว่า **ขึ้นต้นด้วย** อะไร มี **สิทธิ์การเข้าถึง** แบบใด **ใช้ล่าสุด** เมื่อใด และ **หมดอายุ** เมื่อใด

- **หากต้องการเปลี่ยนโทเค็น** ให้เลือก **เปลี่ยนโทเค็น…** แล้วเลือก **เปลี่ยนโทเค็น** เพื่อยืนยัน โทเค็นใหม่จะมาแทนที่โทเค็นเดิม และโทเค็นเดิมจะหยุดทำงานทันที คัดลอกโทเค็นใหม่ในส่วน **คัดลอกโทเค็นของคุณ**
- **หากต้องการหยุดใช้โทเค็น** ให้เลือก **เพิกถอน…** แล้วเลือก **เพิกถอน** เพื่อยืนยัน ทุกสิ่งที่ใช้โทเค็นนี้จะหยุดทำงานทันที

การสร้าง เปลี่ยน และเพิกถอนโทเค็นจะถูกบันทึกไว้ใน [บันทึกการตรวจสอบ](/docs/teams/audit-log)

## เพิ่มเว็บฮุก

เว็บฮุกส่งเหตุการณ์ใน Livespace ซึ่งเป็นรายการเดียวกับใน [บันทึกการตรวจสอบ](/docs/teams/audit-log) ไปยังที่อยู่ที่คุณเลือก

1. ใน การตั้งค่า › **การเข้าถึง API** ไปที่ส่วน **เว็บฮุก** แล้วเลือก **เพิ่มเว็บฮุก**
2. ป้อน **ชื่อ** และ **URL** โดยใช้ URL แบบ HTTPS ที่เข้าถึงได้จากสาธารณะ
3. ในส่วน **เหตุการณ์** ให้เว้นว่างไว้เพื่อรับทุกเหตุการณ์ หรือระบุการดำเนินการและส่วนงาน เช่น `member.added` หรือ `sharing.*`
4. เลือก **เพิ่ม**
5. ในส่วน **คัดลอกคีย์ลับสำหรับลงลายเซ็น** ให้คัดลอกคีย์ลับ คีย์ลับจะแสดงให้เห็นครั้งนี้ครั้งเดียวเท่านั้น

หาก Dvina แจ้งว่า **Dvina ไม่สามารถเข้าถึงที่อยู่นี้ได้** ให้ใช้ URL แบบ HTTPS ที่เข้าถึงได้จากสาธารณะ

### ตรวจสอบลายเซ็นของแต่ละคำขอ

Dvina ส่งเหตุการณ์เป็นชุดในรูปแบบ JSON และลงลายเซ็นทุกคำขอ ใช้คีย์ลับสำหรับลงลายเซ็นเพื่อตรวจสอบว่าคำขอมาจาก Dvina:

- แต่ละคำขอมีส่วนหัว `X-Dvina-Signature` ในรูปแบบ `t=<timestamp>,v1=<signature>`
- ลายเซ็นคือค่า HMAC-SHA256 ในรูปแบบเลขฐานสิบหก ซึ่งสร้างจากเวลาประทับ เครื่องหมายจุด และเนื้อหาคำขอ โดยใช้คีย์ลับสำหรับลงลายเซ็นของคุณ
- คำนวณค่าด้วยตัวเองแล้วเปรียบเทียบ ปฏิเสธคำขอที่ลายเซ็นไม่ตรงกันหรือมีเวลาประทับเก่าเกินไป

## ตรวจสอบหรือเปลี่ยนแปลงเว็บฮุก

เว็บฮุกของคุณจะแสดงอยู่ในส่วน **เว็บฮุก** พร้อมสถานะ: **เปิด**, **หยุดชั่วคราว** หรือ **ส่งไม่สำเร็จ** เลือกเว็บฮุกเพื่อดูรายละเอียด

- **หากต้องการเปลี่ยนแปลงเว็บฮุก** ให้แก้ไข **ชื่อ**, **URL** หรือ **เหตุการณ์** แล้วเลือก **บันทึก**
- **หากต้องการหยุดชั่วคราว** ให้ปิด **ส่งเหตุการณ์** เปิดอีกครั้งเพื่อเริ่มส่งต่อ
- **หากต้องการดูการทำงานของเว็บฮุก** ให้ตรวจสอบ **สถานะ** และจำนวนเหตุการณ์ที่ **ส่งแล้ว** เว็บฮุกที่ส่งไม่สำเร็จจะแสดง **ข้อผิดพลาดล่าสุด** Dvina จะพยายามส่งต่อไป และบันทึกการส่งที่ไม่สำเร็จไว้ในบันทึกการตรวจสอบ
- **หากต้องการเปลี่ยนคีย์ลับ** ให้เลือก **คีย์ลับสำหรับลงลายเซ็นใหม่…** แล้วยืนยัน คำขอจะใช้คีย์ลับใหม่ในการลงลายเซ็นทันที คุณจึงต้องอัปเดตฝั่งรับทันที
- **หากต้องการลบเว็บฮุก** ให้เลือก **ลบ…** แล้วเลือก **ลบ** เพื่อยืนยัน จะไม่มีการส่งข้อมูลไปยังเว็บฮุกนี้อีก

## ที่เกี่ยวข้อง

- [ใช้ Dvina จากแอปอื่นผ่าน MCP](/docs/dvina-mcp/overview)
- [ใช้บันทึกการตรวจสอบ](/docs/teams/audit-log)
- [ภาพรวมของทีม](/docs/teams/overview)