شارك المقالة
إرسال Query Parameters مع POST في Flutter باستخدام Dio

إرسال Query Parameters مع POST في Flutter باستخدام Dio

أرسل Query Parameters مع POST في Flutter عبر Dio، وافصل معاملات الرابط عن جسم JSON ورمز المصادقة مع ترميز القيم…

إرسال Query Parameters مع POST في Flutter لا يعني وضع كل البيانات في رابط مركب نصيًا. قد يطلب عقد API معاملات في الرابط وجسم JSON ورأس مصادقة في الوقت نفسه؛ لكل جزء مكانه. نستخدم Dio لتشفير قيمة bookID بدل لصقها بعد علامة الاستفهام يدويًا.

مثال POST مع معاملات ورمز جلسة

المقطع التالي يوضح خدمة إزالة كتاب محفوظ وفق عقد توضيحي يستخدم POST. اسم المسار ليس خدمة عامة جاهزة؛ استبدله بنقطة API التي تملكها وراجع هل تطلب DELETE أو POST. لا تغير طريقة HTTP من جهة العميل دون اتفاق مع الخادم.

import 'package:dio/dio.dart';

Future<Response<Object?>> removeSavedBook(Dio dio, String bookId, String token) {
  if (bookId.isEmpty || token.isEmpty) throw ArgumentError('Missing input');
  return dio.post<Object?>('/remove_book_saved',
      queryParameters: {'bookID': bookId},
      options: Options(headers: {'Authorization': 'Bearer $token'}));
}

queryParameters تختلف عن data

تُرسل bookID في الرابط لأن المثال يفترض ذلك. إذا طلب الخادم JSON استخدم data بخريطة القيم بدل نقلها إلى queryParameters. أما رفع ملف فيحتاج FormData وموافقة العقد على نوع multipart. كتابة Content-Type عشوائيًا لا تحول شكل المحتوى إلى الصيغة المطلوبة.

Bearer في رأس Authorization هنا افتراض موضح؛ بعض الخدمات تستخدم تنسيقًا آخر. لا تضع الرمز في query لأنه قد يظهر في السجلات والتاريخ، ولا تطبعه عند الخطأ. إذا كان المعرّف يحتوي مسافة أو رمز & فإن queryParameters يحافظ عليه كقيمة واحدة بدل تقسيم الرابط إلى معاملات غير مقصودة.

التأكد من النتيجة

انتظر الاستجابة وافحص معناها وفق العقد قبل إزالة الكتاب من القائمة بصورة نهائية. بعض الخوادم تعيد HTTP 200 مع status يفيد الرفض، وبعضها يعيد 204 بلا جسم عند النجاح. لا تفرض قراءة JSON على استجابة فارغة صحيحة، ولا تكرر طلب تغيير الحالة تلقائيًا عند كل rebuild.

اختبر قيمة تحتوي رموزًا خاصة، وطلبًا بلا معرّف، وجلسة منتهية، وحذفًا مكررًا. بعد النجاح حدّث الكاش والقائمة أو أعد قراءتهما. احتفظ بمعالجة النقل في Repository وبعرض الرسائل في الواجهة، حتى تستطيع اختبار ترميز المعاملات دون تشغيل شاشة كاملة.

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

لإكمال هذا الجزء، انتقل إلى جلب الأخبار باستخدام Dio في Flutter وقراءة استجابة API، ثم طبّق الربط الذي يناسب بنية مشروعك.

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

كيفية اضافة بيانات في الparams داخل flutter
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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