ApiServices class abstract interface

A typed HTTP client wrapping Dio. All methods return Either<Failure, Response> — use .fold(onLeft, onRight) to handle errors and successes without exceptions.

Setup

Call configure once at app startup (before any request) to enable token auth and automatic token refresh on 401:

ApiServices.configure(
  getToken: () async => await storage.read('token'),
  onTokenRefresh: () async => await authRepo.refresh(),
  onRefreshFailed: () => Get.offAllNamed(Routes.login),
);

If you don't need token auth, skip configure and use instance directly.

Making requests

final result = await ApiServices.instance().get(endpoint: '/users');

result.fold(
  (failure) => print(failure.message),
  (response) => print(response.data),
);

Or inject via your DI framework and wrap in your own service layer:

final result = await _apiServices.post(
  endpoint: '/orders',
  data: order.toJson(),
);