توثیق
لاگ ان، ٹوکن کی تجدید، پاس ورڈ ری سیٹ، SSO کی تکمیل - اور API کلید کے ذریعے API رسائی۔
یہ گروپ صارفین کے لاگ ان کو شامل کرتا ہے: ای میل ایڈریس یا صارف نام اور پاس ورڈ کے ساتھ لاگ ان، Refresh-Token کے ذریعے سیشن کی تجدید، بھولے ہوئے پاس ورڈ کا ری سیٹ اور سنگل سائن آن (SAML/OIDC) کی تکمیل۔ اینڈ پوائنٹس ایک ایکسیس ٹوکن (JWT) واپس کرتے ہیں جو ہیڈر `Authorization: Bearer <token>` میں بھیجا جاتا ہے، نیز ایک Refresh-Token جو ہر استعمال پر نئے سے بدل جاتا ہے۔
اپنے پروگراموں سے اپنے ڈیٹا تک مشینی رسائی کے لیے، صارف لاگ ان کے بجائے `https://zentor-app.de/api/v1` پر REST-API کے لیے API کلید استعمال کریں۔ Zentor درخواست پر API رسائی فعال کرتا ہے؛ پھر ایڈمنسٹریٹرز ڈیش بورڈ میں "API کلیدیں" کے تحت متعین اجازتوں (Scopes) کے ساتھ کلیدیں بناتے ہیں۔ کلید ہیڈر `Authorization: Bearer <API-کلید>` یا `X-API-Key` میں منتقل کی جاتی ہے۔ Scopes، ایرر کوڈز اور محفوظ ذخیرہ کرنے کی ہدایات API ریفرنس کے جائزے میں ملتی ہیں۔
لاگ ان اینڈ پوائنٹس کو بار بار غلط کوششوں سے محفوظ کیا گیا ہے: کئی غلط اندراجات کے بعد، سرور مزید کوششوں میں تاخیر کرتا ہے اور عارضی طور پر 429 `RATE_LIMIT_EXCEEDED` کے ساتھ انہیں بلاک کرتا ہے۔