شارك المقالة
no image

تسجيل الدخول باستخدام API في Flutter: نجاح الطلب والتحقق من الجلسة

نفّذ تسجيل الدخول باستخدام API في Flutter مع التحقق من استجابة الخادم ومعالجة الرفض وتخزين رمز الجلسة دون طباعة كلمة…

تسجيل الدخول باستخدام API في Flutter يجمع نموذج إدخال وطلب شبكة وتحققًا من الاستجابة وحفظ جلسة. نجاح HTTP وحده لا يكفي؛ قد يعيد الخادم status يرفض الدخول داخل استجابة 200. كذلك لا تحتاج شاشة الدخول إلى طباعة كلمة المرور أو جسم الاستجابة الذي يحتوي token للتأكد من عملها.

عقد الخادم أولًا

المثال التالي يفترض /login في API تملكه، ويرسل email وpassword ويستقبل status وdata.token. هذا عقد توضيحي يجب تكييفه مع خادمك، وليس وعدًا بأن عنوان خدمة تعليمية قديم ما زال يعمل. أنشئ Dio بقاعدة HTTPS ومهلات، ثم مرره إلى LoginService.

import 'package:dio/dio.dart';

class LoginService {
  LoginService(this.dio);
  final Dio dio;
  // Example backend contract: {"status": true, "data": {"token": "..."}}.
  Future<String> login(String email, String password) async {
    final response = await dio.post<Object?>('/login', data: {
      'email': email.trim(), 'password': password,
    });
    final body = response.data;
    if (body is! Map<String, dynamic> || body['status'] != true) {
      throw const FormatException('Login rejected');
    }
    final data = body['data'];
    final token = data is Map<String, dynamic> ? data['token'] : null;
    if (token is! String || token.isEmpty) {
      throw const FormatException('Missing session token');
    }
    return token;
  }
}

إدارة النموذج وحالة العملية

تحقق من البريد وعدم فراغ كلمة المرور قبل الإرسال، ولا تطبق trim على كلمة المرور لأن المسافات قد تكون جزءًا صحيحًا منها. اجعل TextEditingController مملوكًا لـState وحرره في dispose. عطّل زر الدخول أثناء الطلب واعرض حالة خطأ مناسبة دون تحويل كل رفض إلى «لا يوجد إنترنت».

بعد إرجاع الرمز احفظه بالتخزين الآمن عبر SessionStore في الدرس المرتبط، ثم انتقل بعد نجاح الحفظ. إذا استخدمت context بعد await فتحقق من mounted. لا تخزن كلمات المرور في SharedPreferences، ولا تحفظ الرمز في متغير عام يطبع تلقائيًا عند بداية التطبيق.

نجاح الجلسة وانتهاؤها

وجود الرمز محليًا لا يعني أنه صالح إلى الأبد. يحتاج التطبيق إلى سياسة تحقق وتجديد وخروج متوافقة مع الخادم، ومعالجة 401 دون حلقات إعادة طلب لا تنتهي. لا تجعل واجهة المستخدم هي من تمنح الصلاحية؛ الخادم يفرضها على كل عملية محمية.

اختبار الدخول دون حسابات حقيقية

استخدم محول Dio وهميًا لاختبار نجاح، ورفض 200 مع status:false، ورمز مفقود أو فارغ، وHTTP 401 ومهلة زمنية. اختبر فشل حفظ التخزين كي لا تعرض الصفحة الرئيسية مع جلسة لم تُحفظ كما تقصد. أمثلة هذا المقال لا ترسل بيانات مستخدمين ولا تختبر الدخول إلى خدمة خارجية فعلية.

مراجع التنفيذ

لإكمال هذا الجزء، انتقل إلى تحويل JSON إلى Model في Flutter مع Null Safety والتحقق من الأنواع، ثم طبّق الربط الذي يناسب بنية مشروعك.

صور الشرح السابق

كود التعامل مع روابط api الاكواد المستخدمه داخل ملف cubit كود التصميم النهائي الخاص بصفحة تسجيل الدخول
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع