Налаштування Alamofire для мережевих запитів у iOS-додатку

Налаштування Alamofire для мережевих запитів у iOS-додатку

Ви використовуєте URLSession і щоразу пишете десятки рядків для оновлення токена, обробки 401, завантаження файлів? Alamofire 5 вирішує це з коробки. Ми часто бачимо проєкти, де мережевий шар розмазаний по контролерах — це призводить до дублювання коду, складності тестування та багів при зміні API. Натомість ми закладаємо правильну архітектуру з першого дня, використовуючи перевірені патерни.

Alamofire — це не просто обгортка над URLSession. Це фреймворк з підтримкою async/await, Combine, ланцюжків запитів, автоматичних ретраїв та certificate pinning. Для додатків з авторизацією, завантаженням медіа та суворими вимогами до безпеки він незамінний. Давайте розберемо, як налаштувати його професійно, щоб заощадити до 40% часу на розробку мережевого шару.

Чому AF.request() з ViewModel — антипатерн?

Прямий виклик AF.request(...) з ViewModel створює жорсткий зв'язок з фреймворком і ускладнює юніт-тестування. Натомість мережевий шар ізолюється через протоколи. Ми використовуємо трирівневу архітектуру:

• APIClient — синглтон/ін'єкція, який тримає Session з конфігурацією.
• Router — enum з URLRequestConvertible для всіх ендпоінтів.
• Моделі — Codable структури.

enum UserRouter: URLRequestConvertible {
    case getProfile(id: String)
    case updateProfile(UserUpdateRequest)

    var method: HTTPMethod {
        switch self {
        case .getProfile:
            return .get
        case .updateProfile:
            return .patch
        }
    }

    func asURLRequest() throws -> URLRequest {
        var request = try URLRequest(url: baseURL.appendingPathComponent(path))
        request.method = method
        return try encoder.encode(self, into: request)
    }
}

Такий підхід гарантує, що кожен endpoint описаний одноманітно, а тестувати можна, передаючи mock-реалізацію APIClientProtocol. У результатах — зниження багів на 60% при рефакторингу API.

Як автоматично оновлювати access token?

Без RequestInterceptor вам довелося б вручну перевіряти статус відповіді, викликати refresh і повторювати запит. Alamofire робить це прозоро:

class AuthInterceptor: RequestInterceptor {
    func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest, Error>) -> Void) {
        var request = urlRequest
        request.headers.add(.authorization(bearerToken: tokenStore.accessToken))
        completion(.success(request))
    }

    func retry(_ request: Request, for session: Session, dueTo error: Error, completion: @escaping (RetryResult) -> Void) {
        guard request.response?.statusCode == 401 else {
            completion(.doNotRetry)
            return
        }
        refreshToken { result in
            switch result {
            case .success:
                completion(.retry)
            case .failure(let e):
                completion(.doNotRetryWithError(e))
            }
        }
    }
}

Session з цим інтерцептором автоматично додає токен і повторює запит після оновлення — прозоро для коду, що викликає. Економить близько 20 рядків на кожен захищений endpoint. У проєкті з 10+ ендпоінтами це скорочує код на 200+ рядків і запобігає помилкам синхронізації токенів.

Декодування та обробка помилок

responseDecodable(of:) з JSONDecoder — стандарт. Кастомний JSONDecoder з dateDecodingStrategy і keyDecodingStrategy задаємо один раз в APIClient. Це гарантує консистентність по всьому додатку.

Серверні помилки часто приходять у вигляді JSON з кодом та повідомленням. ResponseSerializer кастомний або validate() + обробка в mapError:

session.request(router)
    .validate(statusCode: 200..<300)
    .responseDecodable(of: T.self, decoder: decoder) { response in
        switch response.result {
        case .success(let value):
            // ok
        case .failure(let error):
            if let data = response.data, let apiError = try? decoder.decode(APIError.self, from: data) {
                // показуємо apiError.message
            }
        }
    }

Так ми одноманітно обробляємо помилки авторизації, валідації та серверні збої. Без цієї логіки користувачі бачили б неінформативні повідомлення.

Multipart та завантаження файлів

Завантаження зображень через upload(multipartFormData:):

session.upload(multipartFormData: { formData in
    formData.append(imageData, withName: "photo", fileName: "photo.jpg", mimeType: "image/jpeg")
}, with: router)
.uploadProgress { progress in
    updateProgressBar(progress.fractionCompleted)
}

uploadProgress працює на main queue за замовчуванням при вказанні .main черги — інакше оновлюємо UI через DispatchQueue.main.async. На відміну від URLSession, Alamofire дозволяє задати прогрес у 2 рядки замість 10.

Certificate Pinning

Для додатків з чутливими даними налаштовуємо certificate pinning через ServerTrustManager:

let manager = ServerTrustManager(evaluators: [
    "api.example.com": PinnedCertificatesTrustEvaluator()
])
let session = Session(serverTrustManager: manager)

Сертифікати кладемо в Bundle. При ротації сертифіката на сервері потрібно оновити додаток — без цього всі запити впадуть з SSL error. Тому в enterprise-проєктах часто використовуємо public key pinning замість повного сертифіката. Це компроміс: безпека вища, але потребує оновлень при зміні ключів.

Порівняння підходів: URLSession vs Alamofire

Alamofire скорочує час розробки мережевого шару на 40–60% порівняно з чистим URLSession. У проєктах з 50+ endpoint'ами це економить до 3 днів на початкове налаштування.

Чому варто обрати Alamofire замість URLSession?

Основні причини: автоматичні ретраї, вбудована підтримка async/await, зручний multipart та можливість легко підмінити сесію для тестів. Alamofire — індустріальний стандарт для iOS-команд, і його використання підвищує читабельність коду. На практиці він знижує кількість рядків мережевого коду на 30–50%, а час на налагодження — на 25%.

Як налаштувати certificate pinning для безпеки?

Використовуйте ServerTrustManager з одним із трьох режимів: PinnedCertificatesTrustEvaluator (повний сертифікат), PublicKeysTrustEvaluator (тільки публічний ключ) або CompositeTrustEvaluator (комбінація). Рекомендуємо public key pinning для гнучкості: при зміні сертифіката не потрібно релізити нову версію додатка, достатньо оновити ключ на сервері. Налаштування займає 5 хвилин, але захищає від MITM-атак.

Що входить в роботу

• Налаштування Session з кастомним RequestInterceptor для авторизації
• Router на основі URLRequestConvertible для всіх ендпоінтів
• Кастомний JSONDecoder з потрібними стратегіями
• Обробка мережевих та серверних помилок
• Завантаження файлів з прогресом
• Опціонально: certificate pinning, logging interceptor

Терміни

Базовий мережевий шар з роутером та авторизацією: 1 день. З multipart, SSL pinning, retry стратегією та повним покриттям помилок: 2–3 дні. Вартість розраховується індивідуально.

Хочете таку архітектуру у вашому проєкті? Зв'яжіться — ми оцінимо вашу поточну реалізацію та запропонуємо оптимальне рішення. Замовте налаштування Alamofire під ключ — отримайте надійний мережевий шар, готовий до зростання навантаження. Наш досвід: понад 20 проєктів з iOS-мережевими рішеннями, включаючи fintech та healthtech з високими вимогами до безпеки.