مقدمة إلى Dio: الإعداد والطلبات الأساسية

# pubspec.yaml
dependencies:
  flutter:
    sdk: flutter
  dio: ^5.4.0        # استخدم أحدث إصدار مستقر

import 'package:dio/dio.dart';

import 'package:dio/dio.dart';

class ApiClient {
  static final Dio _dio = Dio(
    BaseOptions(
      baseUrl: 'https://api.example.com/v1/',
      connectTimeout: const Duration(seconds: 10),
      receiveTimeout: const Duration(seconds: 15),
      headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json',
      },
    ),
  );

  // كشف النموذج المُهيَّأ
  static Dio get instance => _dio;
}

import 'package:dio/dio.dart';

class PostService {
  final Dio _dio;

  PostService(this._dio);

  // GET — جلب قائمة من المنشورات
  Future<List<dynamic>> fetchPosts() async {
    final Response response = await _dio.get('posts');
    // response.data هو JSON مُفكَّك بالفعل (List أو Map)
    return response.data as List<dynamic>;
  }

  // GET مع معاملات الاستعلام
  Future<Map<String, dynamic>> fetchPost(int id) async {
    final Response response = await _dio.get(
      'posts/$id',
      queryParameters: {'include': 'comments'},
    );
    return response.data as Map<String, dynamic>;
  }

  // POST — إنشاء منشور جديد
  Future<Map<String, dynamic>> createPost(String title, String body) async {
    final Response response = await _dio.post(
      'posts',
      data: {'title': title, 'body': body, 'userId': 1},
    );
    return response.data as Map<String, dynamic>;
  }

  // PUT — استبدال منشور موجود
  Future<Map<String, dynamic>> updatePost(int id, String title) async {
    final Response response = await _dio.put(
      'posts/$id',
      data: {'title': title, 'body': 'Updated body', 'userId': 1},
    );
    return response.data as Map<String, dynamic>;
  }

  // DELETE — حذف منشور
  Future<void> deletePost(int id) async {
    await _dio.delete('posts/$id');
  }
}

Future<void> safeFetch() async {
  try {
    final response = await ApiClient.instance.get('posts/1');
    print('Status: ${response.statusCode}');
    print('Data: ${response.data}');
  } on DioException catch (e) {
    switch (e.type) {
      case DioExceptionType.connectionTimeout:
      case DioExceptionType.receiveTimeout:
        print('انتهت مهلة الطلب.');
        break;
      case DioExceptionType.badResponse:
        // الخادم رد بحالة غير 2xx
        final status = e.response?.statusCode;
        print('خطأ في الخادم: $status — ${e.response?.data}');
        break;
      case DioExceptionType.connectionError:
        print('لا يوجد اتصال بالإنترنت.');
        break;
      default:
        print('خطأ غير متوقع: ${e.message}');
    }
  }
}