ch11s1_WhatAreAPIs

APIs (Application Programming Interfaces) are **bridges that let software systems talk to each other**.

Chapter 11: Working with APIs — What Are APIs?

🌉 What Are APIs? — Understanding Application Programming Interfaces

APIs (Application Programming Interfaces) are bridges that let software systems talk to each other.
They define how programs can request and exchange data, making integration between services simple and standardized.

🧩 1. Real-World Analogy

Think of an API like a restaurant menu:

• The menu (API documentation) lists what you can order (available actions).
• The waiter (API server) takes your order and delivers it to the kitchen (backend system).
• You don’t see how the food is made — you just get the result.

That’s exactly how applications communicate — through structured requests and responses.

🧠 2. Why APIs Matter

APIs are the backbone of modern web and mobile development — from social apps to IoT systems.

🌐 3. Types of APIs

🧱 4. Anatomy of an API Request

Most APIs use HTTP — the same protocol your browser uses.

💻 5. Making API Calls in Python

The requests library is the simplest way to interact with APIs.

import requests

url = "https://jsonplaceholder.typicode.com/posts/1"
response = requests.get(url)

# Convert JSON to Python dict
data = response.json()
print("Title:", data["title"])
print("Body:", data["body"])

⚙️ 6. Sending Data with POST Requests

Some APIs let you send or create data using POST requests.

import requests

url = "https://jsonplaceholder.typicode.com/posts"
payload = {"title": "New Post", "body": "Hello World", "userId": 1}
response = requests.post(url, json=payload)

print("Status:", response.status_code)
print("Response:", response.json())

✅ Use json=payload instead of data=payload to automatically send JSON content.

🕵️ 7. Adding Headers and Query Parameters

You can pass authentication tokens and query filters easily:

url = "https://api.openweathermap.org/data/2.5/weather"
params = {"q": "London", "appid": "YOUR_API_KEY"}
headers = {"User-Agent": "MyPythonApp/1.0"}

response = requests.get(url, params=params, headers=headers)
print(response.url)  # Full request URL

🧠 8. Handling Errors Gracefully

APIs can fail — always check the response.

response = requests.get("https://jsonplaceholder.typicode.com/posts/1")

if response.status_code == 200:
    print("Success:", response.json())
elif response.status_code == 404:
    print("Not Found!")
else:
    print("Error:", response.status_code)

🔐 9. Authentication — Accessing Protected APIs

Many APIs require credentials to ensure authorized access.

API Keys

Simplest method — passed as a query parameter or header.

headers = {"Authorization": "Bearer YOUR_TOKEN"}
response = requests.get("https://api.github.com/user", headers=headers)
print(response.json())

🔒 Always store keys securely using environment variables, not in your code.

import os
API_KEY = os.getenv("GITHUB_API_KEY")

🧩 10. Parsing JSON Responses

Most APIs return JSON (JavaScript Object Notation) — easy to use in Python.

data = response.json()
for key, value in data.items():
    print(key, ":", value)

You can also serialize data back to JSON:

import json

python_data = {"name": "Alice", "age": 25}
json_string = json.dumps(python_data)
print(json_string)

🧭 11. Comparing REST, GraphQL, and WebSocket APIs

🧰 12. Testing and Debugging APIs

Example:

curl https://jsonplaceholder.typicode.com/posts/1

🛰️ 13. Real-World Example — SpaceX Launch API

import requests

url = "https://api.spacexdata.com/v5/launches/latest"
response = requests.get(url)

if response.ok:
    data = response.json()
    print("Mission:", data["name"])
    print("Date:", data["date_utc"])
    print("Rocket:", data["rocket"])

🚀 APIs like this power dashboards, mobile apps, and live-tracking tools.

💡 14. Best Practices for Using APIs

✅ Check API docs and usage limits.
✅ Always handle errors and rate limits.
✅ Use environment variables for API keys.
✅ Cache responses for performance.
✅ Respect terms of service and attribution.
✅ Test with Postman or curl before writing code.
✅ Prefer pagination for large data sets.

🧠 Summary

APIs are the glue of modern applications — once you understand how to call and handle them, you can connect to nearly any service or dataset on the internet.