الانتقال إلى المحتوى الرئيسي
GET
الحصول على الجلسة
المصادقة ميزة جديدة. تُقدَّم هذه endpoints من خلال المُصدِر الخاص بتطبيقك، مثل https://<name>.auth.didit.me، ولا تقبل أبدًا مفتاح API الخاص بك في Didit.
هذا فحص الإلغاء الفوري. يسمح بـ 30 طلبًا في الدقيقة و300 طلب في الساعة لكل عنوان IP، لذا تحقّق من token دون اتصال في كل طلب، واستدعه قبل الإجراءات الحساسة. راجع تحقق من الجلسة.

التفويضات

Authorization
string
header
مطلوب

token الوصول الخاص بالشخص من POST /token/: عبارة عن ES256 JWT برأس typ: at+jwt، صالح لمدة 5 دقائق كحد أقصى. ليس مفتاح API الخاص بك في Didit.

الاستجابة

الجلسة نشطة.

الجلسة المباشرة المرتبطة بـ token الوصول.

sub
string<uuid>
مطلوب

معرّف الهوية.

مثال:

"1c9d8b88-1bff-43d1-ad7a-88b2bc0024e9"

sid
string<uuid>
مطلوب

معرّف الجلسة.

مثال:

"c9abf6cc-2d64-4bf2-b31e-a4d09a070ab1"

application_id
string<uuid>
مطلوب
مثال:

"7b0a6c2e-3f41-4c9a-8d55-1e2f3a4b5c6d"

vendor_data
string
مطلوب

مرجع الشخص عبر منتجات Didit، كما هو موضح في الـ token.

مثال:

"user-42"

amr
string[]
مطلوب

طريقة تسجيل الدخول للجلسة، كقيمة واحدة: على سبيل المثال password، أو code (رمز البريد الإلكتروني)، أو magic (الرابط السحري)، أو passkey، أو phone، أو sso، أو wallet (محفظة Didit ID Wallet)، أو اسم طريقة تسجيل دخول عبر وسائل التواصل الاجتماعي. يكون فارغاً لـ token الخاص بالوكيل.

مثال:
mfa_verified
boolean
مطلوب

ما إذا كانت الجلسة قد اجتازت عاملاً ثانياً. تكون دائماً true لتسجيل الدخول باستخدام مفتاح المرور.

مثال:

false

email
string<email> | null
مطلوب
مثال:

"person@example.com"

email_verified
boolean
مطلوب
مثال:

true

phone
string | null
مطلوب

رقم هاتف بتنسيق E.164، أو null.

مثال:

null

verified_identity
object | null
مطلوب

ما تمت مشاركته بواسطة Didit ID Wallet عند تسجيل الدخول. يكون null عندما يسجل الشخص دخوله بطريقة أخرى.

verified
object | null
مطلوب

مستوى التحقق والمطالبات المحددة، وهو نفس الكائن الذي تحمله الرموز تحت verified، أو null عند عدم وجود أي منها. اقرأ هذا، وليس email_verified، لمعرفة ما إذا كان الشخص قد أجرى التحقق من هويته.

expires_at
string<date-time>
مطلوب

متى تنتهي الجلسة كحد أقصى. يمكن لمهلة الخمول إنهاؤها قبل ذلك.

مثال:

"2026-11-16T10:41:14.347557Z"

post_logout_redirect_uri
string
مطلوب

المكان الذي يرسل تطبيقك الشخص إليه بعد تسجيل الخروج. سلسلة نصية فارغة عندما لا تكون معينة.

مثال:

"https://app.example.com/"

organizations
object[]
مطلوب

كل مؤسسة عميل ينتمي إليها الشخص، عند تفعيل المؤسسات. وتكون فارغة بخلاف ذلك.

آخر تعديل في ٧ نوفمبر ٢٠٢٦