Making GET Requests and Handling Responses

Welcome to the second lesson in our journey of interacting with APIs using Scala 3 and the Requests-Scala library. In the previous lesson, we laid a strong foundation for understanding RESTful APIs and how HTTP requests facilitate interactions with them. We used curl to manually send a GET request to an endpoint. Now, we are transitioning to automating this process using Scala. This lesson introduces Requests-Scala, which allows us to send HTTP requests effortlessly in our Scala applications, making it an invaluable tool in the realm of web development and API integration.

To make HTTP requests in Scala, we use the Requests-Scala library, which provides a simple and powerful API for handling HTTP requests. To get started, you'll need to add the following dependencies to your build.sbt file:

libraryDependencies += "com.lihaoyi" %% "requests" % "0.6.9"
libraryDependencies += "com.lihaoyi" %% "ujson" % "3.1.3"

Once the dependencies are added, you can import the necessary packages in your Scala code, making their functionalities available for sending HTTP requests and handling JSON:

import requests.*
import ujson.*

With this setup, you'll be equipped to automate requests, saving time and boosting efficiency in your development workflow.

When interacting with an API, it's helpful to define a base URL for the service you're communicating with. This makes your code more modular and easy to maintain, allowing you to change the root of your API URL in one place without modifying each request.

// Base URL for the API
val baseUrl = "http://localhost:8000"

By setting this baseUrl, we can easily concatenate endpoints for different services within the API, making our code cleaner and more adaptable.

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

// Fetch all todos using the get method
val responseTry = Try(requests.get(s"$baseUrl/todos"))

// Handle response success or failure
responseTry match {
  case Success(response) =>
    // Print raw response
    println("Raw Response:")
    println(response.text())

    // Continue with response handling based on status codes ...
  case Failure(exception) =>
    println(s"Failed to fetch todos: ${exception.getMessage}")
}

By using the requests.get() method, we send a GET request to the constructed full URL. The response from the server, stored in the variable response, is then printed using response.text(), which gives us the raw response body as a string.

Here's an example of what the raw response might look like:

Raw Response:
[
  {
    "description": "Milk, eggs, bread, and coffee",
    "done": false,
    "id": 1,
    "title": "Buy groceries"
  },
  {
    "description": "Check in and catch up",
    "done": true,
    "id": 2,
    "title": "Call mom"
  },
  {
    "description": "Summarize Q4 performance metrics",
    "done": false,
    "id": 3,
    "title": "Finish project report"
  },
  {
    "description": "30 minutes of cardio",
    "done": true,
    "id": 4,
    "title": "Workout"
  }
]

This raw output allows us to see the immediate result returned by the server, serving as a starting point for further processing of the data.