auth
يسمح لك بمصادقة المستخدمين.
Description
يعيد Promise يتم حله إلى كائن IAuthEntity.
AuthProvider.auth(
marker*,
body*
);
Parameters schema
Schema
marker(required): string
معرف النص لمزود التفويض
مثال: "email"
body(required): IAuthPostBody
كائنات تحتوي على معلومات المصادقة
مثال:
{
"authData": [
{
"marker": "login",
"value": "example@oneentry.cloud"
},
{
"marker": "password",
"value": "12345"
}
]
}
body.authData(required): IAuthData[]
مصفوفة من كائنات بيانات المصادقة، كل منها يحتوي على معرف وقيمته المقابلة.
مثال:
[
{
"marker": "login",
"value": "user@example.com"
}
]
authData.marker(required): string
المعرف الذي يحدد حقل المصادقة.
مثال: "login"
authData.value(required): string
قيمة حقل المصادقة.
مثال: .com"
body.authData any[]
بيانات المصادقة المأخوذة من النموذج المرتبط بمزود التفويض
مثال: ""
[
{
"marker": "login",
"value": "example@oneentry.cloud"
},
{
"marker": "password",
"value": "12345"
}
]
body.authData[index].marker string
معرف خاصية تسجيل الدخول في نموذج التسجيل
مثال: "example@oneentry.cloud"
body.authData[index].value string
قيمة خاصية تسجيل الدخول في نموذج التسجيل
مثال: "12345"
Examples
Minimal example
const body = { "authData": [ { "marker": "login", "value": "example@oneentry.cloud" }, { "marker": "password", "value":"12345" } ]};
const response = await AuthProvider.auth('email', body);
Example response
{
"userIdentifier": "test@test.ru",
"authProviderIdentifier": "email",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpX...",
"refreshToken": "1780843256996-94d70096-10a1-41f4..."
}
Response schema
Schema: IAuthEntity
userIdentifier: string
المعرف الفريد للمستخدم.
مثال: "user12345"
authProviderIdentifier: string
المعرف لمزود المصادقة.
مثال: "email"
accessToken: string
رمز الوصول لجلسة المستخدم.
مثال: "abcdef123456"
refreshToken: string
رمز التحديث لتجديد رمز الوصول.
مثال: "ghijkl789012"
Usage examples
خطوات تفصيلية في الوثائق:
- تحديث المستخدم — مصادقة، ثم تحديث حقول ملف تعريف المستخدم.
- تاريخ الطلب — مصادقة المستخدم، ثم جلب تاريخ طلباتهم الشخصية.
- دفع الطلب — مصادقة قبل تقديم الطلب ودفعه.
- اشتراك الطلب — مصادقة، ثم التحقق من وجود اشتراك نشط.
- طلب التذاكر — مصادقة كجزء من عملية الدفع للتذاكر.
- طلب الضيف — تسجيل الدخول كضيف قبل تقديم الطلب.
- تسجيل المستخدم — مصادقة مباشرة بعد التسجيل.
Try it live
قم بتشغيل هذه الطريقة بشكل تفاعلي في JS SDK sandbox — قم بتوصيل عنوان مشروعك ورمز التطبيق عند الزيارة الأولى، ثم افتح أي سيناريو أدناه لرؤية تدفقات المصادقة الحقيقية:
- تحديث المستخدم — مصادقة، ثم تحديث حقول ملف تعريف المستخدم.
- تاريخ الطلب — مصادقة المستخدم، ثم جلب تاريخ طلباتهم الشخصية.
- دفع الطلب — مصادقة قبل تقديم الطلب ودفعه.
- اشتراك الطلب — مصادقة، ثم التحقق من وجود اشتراك نشط.
- طلب التذاكر — مصادقة كجزء من عملية الدفع للتذاكر.
- طلب الضيف — تسجيل الدخول كضيف قبل تقديم الطلب.
- إعادة تعيين كلمة المرور — تسجيل الدخول مرة أخرى مباشرة بعد تغيير المستخدم لكلمته السرية.
- تسجيل المستخدم — مصادقة مباشرة بعد التسجيل.