Making GET Requests and Handling Responses in Swift

Welcome to the second lesson in our journey of interacting with APIs in Swift. Previously, we laid a strong foundation by understanding RESTful APIs and how HTTP requests enable interactions with them. This lesson introduces URLSession, a powerful native framework in Swift for making HTTP requests and handling responses directly in our code. By using Swift's URLSession, we can efficiently automate the process of interacting with APIs, thus enhancing our development workflow in iOS applications.

To make HTTP requests in Swift, we use URLSession, which is a built-in API provided by Apple's Foundation framework. This means you don’t need to install any additional libraries to start working with it. Simply import the Foundation framework at the top of your Swift file:

import Foundation
import FoundationNetworking

With this setup, you'll be ready to use URLSession to automate requests and handle API integration efficiently.

When interacting with an API in Swift, it's useful to define a base URL for the endpoint you are working with. This makes the code more modular and easier to maintain, allowing you to update the base URL for your API requests in a single place.

// Base URL for the API
let baseURL = "http://localhost:8000"

By defining the baseURL as a constant, your code becomes cleaner and more adaptable for future changes.

Let's dive into the process of fetching data from an API using Swift's URLSession. Our goal is to retrieve a list of to-do items from the /todos endpoint using the GET method.

// Create URL
if let url = URL(string: "\(baseURL)/todos") {
    let dispatchGroup = DispatchGroup()
    dispatchGroup.enter()

    // Create a URLSession data task
    let task = URLSession.shared.dataTask(with: url) { data, response, error in
        defer { dispatchGroup.leave() }

        // Check if an error occurred
        if let error = error {
            print("Error occurred: \(error.localizedDescription)")
            return
        }
        
        // Ensure there is data returned from this HTTP response
        guard let data = data else {
            print("No data received")
            return
        }

        // Print raw response
        if let responseString = String(data: data, encoding: .utf8) {
            print("Raw Response:")
            print(responseString)
        }
    }
    
    // Execute the task
    task.resume()
    dispatchGroup.wait()
}

This code snippet demonstrates how to create a data task with URLSession to send a GET request. The response from the server is captured as raw data and printed for verification.