API Example: A Beginner’s Guide with Code Snippets

An Application Programming Interface (API) is the invisible digital glue that allows different software systems to talk to each other. Whether you are checking weather forecasts on your phone, logging into an app using Google, or paying for coffee with Apple Pay, APIs are working behind the scenes.

Understanding APIs: The Restaurant Analogy

The easiest way to understand an API is to think of a restaurant:

1. The Client (You): Sitting at the table, looking at the menu, and wanting to place an order.
2. The API (The Waiter): Takes your order (request), delivers it to the kitchen (server), and brings your food (response) back to your table.
3. The Server (The Kitchen): Prepares the meal, queries the database, and returns the data.

A Real-World API Example

Let’s look at what an actual API request and response look like in practice. Imagine you want to fetch current weather data for a city using a public weather API.

1. The Request

To ask a server for information, your application sends an HTTP Request to a specific endpoint (URL) along with parameters (like the city name and your API key).

GET /v1/weather?city=London&units=metric HTTP/1.1
Host: api.weatherprovider.com
Authorization: Bearer YOUR_API_KEY

2. The Response

The server processes the request, looks up the database, and returns the data—typically formatted as JSON (JavaScript Object Notation).

{
  "city": "London",
  "temperature": "14°C",
  "condition": "Partly Cloudy",
  "humidity": "72%",
  "wind_speed": "12 km/h"
}

Code in Action: Fetching API Data with Python

Here is a quick, self-contained example of how a developer calls an API using Python and the requests library:

import requests

url = "https://api.weatherprovider.com/v1/weather"
params = {"city": "London", "units": "metric"}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(f"Current temperature in {data['city']}: {data['temperature']}")
else:
    print("Failed to retrieve data:", response.status_code)