تجديد الرموز وتدوير الأسرار وإلغاء الربط
اعمل دورة حياة صحيحة للرموز وتوقف عند إلغاء الموافقة.
آخر تحديث تحريري: ٣٠ أكتوبر ٢٠٢٦في هذا الدليل
أعمار الرموز
| العنصر | السلوك الحالي |
|---|---|
| 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 لعميل واحد.