Alamofire for Swift: Complete Guide with Examples

What is Alamofire and why you need it

Alamofire is an elegant and powerful library for working with network requests in Swift. It provides a convenient interface for making HTTP requests, handling responses, uploading and downloading data, as well as working with authentication and serialization. Written in pure Swift, it supports iOS, macOS, tvOS, and watchOS.

Main reasons to use Alamofire:

• Ease of use — an intuitive API that reduces the amount of code compared to URLSession.
• Automatic serialization — built-in support for JSON, Property List, and custom formats.
• Request chaining — easily combine multiple requests and process them sequentially.
• Error handling — detailed information about network and server errors.
• SSL pinning support — secure connection to the server.
• File downloading — support for progress and resumable downloads.
• Active community — regular updates and many examples.

Installing Alamofire

Alamofire is installed via Swift Package Manager (SPM), CocoaPods, or Carthage. The recommended method is SPM.

Installation via Swift Package Manager (SPM)

1. In Xcode, open your project: File → Add Packages...
2. Paste the repository URL: https://github.com/Alamofire/Alamofire.git
3. Select the version (latest stable) and click Add Package.
4. Make sure the package is added to your target.

Installation via CocoaPods

# Podfileplatform :ios, '13.0'use_frameworks!

target 'YourApp' do  pod 'Alamofire', '~> 5.9'end

After that, run pod install.

Installation via Carthage

# Cartfilegithub "Alamofire/Alamofire" ~> 5.9

Then run carthage update --platform iOS.

Quick start with code example

After installation, import the library and make a simple GET request:

import Alamofire

// Simple GET requestAF.request("https://jsonplaceholder.typicode.com/posts/1")    .responseJSON { response in        switch response.result {        case .success(let data):            print("Received data: \\(data)")        case .failure(let error):            print("Error: \\(error.localizedDescription)")        }    }

This code sends a request to a test API, receives JSON, and prints it to the console. Alamofire automatically handles the URL session, request creation, and response serialization.

Main methods and functions of Alamofire

Let's look at 10 key library methods with detailed descriptions and examples.

1. AF.request() — basic HTTP request

What it does: Sends an HTTP request of any method (GET, POST, PUT, DELETE, etc.) to the specified URL.

Parameters:

• _ url: URLConvertible — URL or URL string.
• method: HTTPMethod = .get — HTTP method (get, post, put, delete, patch, etc.).
• parameters: Parameters? = nil — dictionary of request parameters.
• encoding: ParameterEncoding = URLEncoding.default — parameter encoding method.
• headers: HTTPHeaders? = nil — request headers.
• interceptor: RequestInterceptor? = nil — interceptor for modifying the request.

Example:

let parameters: [String: Any] = [    "userId": 1,    "title": "New post",    "body": "Post text"]

AF.request("https://jsonplaceholder.typicode.com/posts",           method: .p