المصادقة

تسجيل الدخول، وتجديد الرمز، وإعادة تعيين كلمة المرور، وإتمام SSO — والوصول إلى الواجهة البرمجية (API) عبر مفتاح API.

تشمل هذه المجموعة تسجيل دخول المستخدمين: تسجيل الدخول بعنوان البريد الإلكتروني أو اسم المستخدم وكلمة المرور، وتجديد الجلسة عبر رمز التجديد (Refresh-Token)، وإعادة تعيين كلمة مرور منسية، وإتمام تسجيل الدخول الموحد (SAML/OIDC). تُرجِع نقاط النهاية رمز وصول (JWT) يُرسل في الترويسة `Authorization: Bearer <token>`، إضافةً إلى رمز تجديد يُستبدَل بآخر جديد عند كل استخدام.

للوصول الآلي من برامجكم الخاصة إلى بياناتكم، استخدموا بدلًا من تسجيل دخول المستخدم مفتاح API للواجهة البرمجية (REST-API) على `https://zentor-app.de/api/v1`. تُفعّل Zentor الوصول إلى الواجهة البرمجية عند الطلب؛ ثم يُنشئ المسؤولون في لوحة التحكم تحت «مفاتيح API» مفاتيح بصلاحيات (Scopes) محدَّدة. يُنقل المفتاح في الترويسة `Authorization: Bearer <API-Schlüssel>` أو `X-API-Key`. تجدون الصلاحيات ورموز الخطأ وملاحظات الحفظ الآمن في نظرة عامة على مرجع الواجهة البرمجية.

نقاط نهاية تسجيل الدخول محمية من المحاولات الخاطئة المتكررة: بعد عدة محاولات خاطئة، يؤخّر الخادم المحاولات التالية ويحظرها مؤقتًا بـ429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← مرجع واجهة برمجة التطبيقات