> For the complete documentation index, see [llms.txt](https://help.zaapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zaapi.com/th/developers/authentication.md).

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

คีย์ API คือข้อมูลรับรองลับที่อนุญาตให้สิ่งที่อยู่นอก Zaapi ดำเนินการบนเวิร์กสเปซได้ เช่น Zaapi [Open API](/th/developers/open-api.md) หรือ [MCP](/th/developers/mcp.md).

### สร้างคีย์ API

ไปที่ **การตั้งค่า → นักพัฒนา → คีย์ API** ในแอป Zaapi

1. คลิก **เพิ่มคีย์ API**.
2. ตั้งชื่อให้ชัดเจน — ใช้ชื่อที่บอกได้ว่ามีไว้สำหรับอะไร เช่น `Claude Desktop` หรือ `การทำงานอัตโนมัติสำหรับซัพพอร์ต`.
3. เลือกขอบเขตสิทธิ์ที่คีย์ควรมี สิทธิ์เหล่านี้กำหนดว่าผู้ช่วยจะเข้าถึงอะไรได้บ้าง: สิทธิ์อ่านช่วยให้ค้นหาข้อมูลได้ ส่วนสิทธิ์เขียนช่วยให้เปลี่ยนแปลงข้อมูลได้ ให้เฉพาะสิทธิ์ที่จำเป็น — คีย์แบบอ่านอย่างเดียวจะส่งข้อความหาลูกค้าหรือปิดทิกเก็ตโดยไม่ตั้งใจไม่ได้
4. คลิกสร้าง แล้ว **คัดลอกคีย์ทันที**.

> **คีย์จะแสดงเพียงครั้งเดียว** จะดูคีย์อีกไม่ได้หลังปิดกล่องโต้ตอบ จึงควรวางไว้ในที่ปลอดภัยก่อนดำเนินการต่อ หากคีย์หาย ให้หมุนคีย์เพื่อรับคีย์ใหม่

**คีย์จะหมดอายุหลัง 6 เดือน** จึงต้องหมุนคีย์และอัปเดตการตั้งค่าก่อนถึงกำหนด

### การจัดการคีย์

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

### ความปลอดภัย

* **ให้ดูแลคีย์ API เหมือนรหัสผ่าน** ผู้ที่มีคีย์นี้จะได้รับสิทธิ์ตามที่กำหนดไว้บนเวิร์กสเปซจริง
* **ห้าม commit คีย์นี้** เก็บคีย์ให้อยู่ภายนอก git — หากใช้ไฟล์คอนฟิกระดับโปรเจกต์ เช่น `.cursor/mcp.json`ให้เพิ่มลงใน `.gitignore`.
* **ให้สิทธิ์ขั้นต่ำที่จำเป็น** เริ่มจากอ่านอย่างเดียว แล้วค่อยเพิ่มสิทธิ์เขียนเมื่อจำเป็น
* **หนึ่งคีย์ต่อหนึ่งคนหรือหนึ่งบริการ** วิธีนี้ช่วยให้หมุนหรือลบคีย์หนึ่งรายการได้โดยไม่กระทบคนอื่น
* **ลบคีย์ที่ไม่ได้ใช้งานแล้ว**รวมถึงกรณีที่สมาชิกออกจากทีม