Andromeda
Note

Web APIs (Python)

Definition

Application Programming Interfaces (APIs) that allow different software systems to communicate over the web using standard protocols (HTTP). In Python, this is primarily facilitated by the requests library.

Why It Matters

In the modern web, you don’t need to build everything from scratch; you just need to know how to “ask.” Web APIs are the currency of the internet economy. Mastery of them allows a single developer to command the power of massive platforms, turning a simple script into a global tool.

Core Concepts

  • API Calls: Specific URLs used to request data (e.g., GitHub’s search API).
  • HTTP Response Codes: 200 (Success), 404 (Not Found), 429 (Too Many Requests/Rate Limited).
  • JSON Response Processing: Most modern APIs return JSON, which is converted to Python dictionaries via response.json().
  • Rate Limiting: Servers often limit the number of requests a client can make in a given time period to prevent abuse.
  • Sorting Metadata: Using operator.itemgetter to sort lists of dictionaries returned by an API (e.g., sorting projects by “stars”).
import requests

# Make an API call
url = "https://api.github.com/zen"
response = requests.get(url)

if response.status_code == 200:
    print(f"GitHub Zen: {response.text}")

Connected Concepts

Connected notes