انتقل للمحتوى
Rasel Mailمركز المساعدة
الأقسام والأدلة
للمطورين

تجديد الرموز وتدوير الأسرار وإلغاء الربط

اعمل دورة حياة صحيحة للرموز وتوقف عند إلغاء الموافقة.

آخر تحديث تحريري: ٣٠ أكتوبر ٢٠٢٦
في هذا الدليل

أعمار الرموز

العنصرالسلوك الحالي
access_tokenصالح لساعة من الإصدار.
refresh_tokenصالح 30 يومًا ويُستبدل عند كل تجديد.
ربط بلا استخداميُلغى بعد 90 يومًا بلا استخدام.
إعادة استخدام refresh قديمتلغي ربط الصندوق لحماية الجلسة؛ اطلب موافقة جديدة.

تجديد من الخادم

طلب refresh_token
curl -i 'https://raselmail.com/api/v1/oauth/token'   -u "$RASEL_CLIENT_ID:$RASEL_CLIENT_SECRET"   --data-urlencode 'grant_type=refresh_token'   --data-urlencode "refresh_token=$RASEL_REFRESH_TOKEN"

احفظ access_token وrefresh_token الجديدين معًا بدل القديمين بشكل ذري. امنع تجديدين متوازيين لنفس الربط بقفل عند تطبيقك؛ إعادة استخدام الرمز القديم ليست إعادة محاولة عادية. عند invalid_grant توقف عن التجديد وابدأ موافقة جديدة.

إلغاء الربط

إلغاء باستخدام الرمز
curl -i 'https://raselmail.com/api/v1/oauth/revoke'   -u "$RASEL_CLIENT_ID:$RASEL_CLIENT_SECRET"   --data-urlencode "token=$RASEL_REFRESH_TOKEN"   --data-urlencode 'token_type_hint=refresh_token'

يمكن للمالك إلغاء الربط من التطبيقات في أي وقت. نجاح طلب الإلغاء لا يثبت أن الرمز كان صالحًا قبل الطلب. تدوير client_secret يلغي كل ارتباطات التطبيق؛ لا تخلطه بتجديد access token لعميل واحد.