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

การเข้าสู่ระบบ การต่ออายุโทเค็น การรีเซ็ตรหัสผ่าน การเสร็จสิ้น SSO – และการเข้าถึง API ด้วยคีย์ API

กลุ่มนี้ครอบคลุมการเข้าสู่ระบบของผู้ใช้: การเข้าสู่ระบบด้วยอีเมลหรือชื่อผู้ใช้และรหัสผ่าน การต่ออายุเซสชันด้วย Refresh Token การรีเซ็ตรหัสผ่านที่ลืม และการเสร็จสิ้นการเข้าสู่ระบบแบบ Single Sign-On (SAML/OIDC) เอนด์พอยต์เหล่านี้จะส่งคืน Access Token (JWT) ซึ่งส่งผ่านส่วนหัว `Authorization: Bearer <token>` และ Refresh Token ซึ่งจะถูกแทนที่ด้วยตัวใหม่ทุกครั้งที่ใช้งาน

สำหรับการเข้าถึงข้อมูลของคุณด้วยโปรแกรมของคุณเอง ให้ใช้คีย์ API สำหรับ REST API ที่ `https://zentor-app.de/api/v1` แทนการเข้าสู่ระบบของผู้ใช้ Zentor จะเปิดใช้งานการเข้าถึง API ตามคำขอ หลังจากนั้นผู้ดูแลระบบจะสร้างคีย์ที่มีสิทธิ์ (scope) ที่กำหนดไว้ในแดชบอร์ดที่ “คีย์ API” คีย์จะถูกส่งผ่านส่วนหัว `Authorization: Bearer <คีย์ API>` หรือส่วนหัว `X-API-Key` สามารถดู scope โค้ดข้อผิดพลาด และคำแนะนำเกี่ยวกับการเก็บรักษาอย่างปลอดภัยได้ในภาพรวมของ API Reference

เอนด์พอยต์การเข้าสู่ระบบได้รับการป้องกันจากความพยายามที่ล้มเหลวซ้ำ ๆ: หลังจากป้อนข้อมูลผิดหลายครั้ง เซิร์ฟเวอร์จะเริ่มล่าช้าในการพยายามครั้งต่อไป และบล็อกชั่วคราวด้วย 429 `RATE_LIMIT_EXCEEDED`

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← เอกสารอ้างอิง API