Introduction to APIs

Introduction to APIs: How Apps Talk to Each Other

What is an API?

API stands for "Application Programming Interface." It's how different software programs talk to each other and share information. Think of it like a restaurant menu: You don't walk into the kitchen and make your own food. Instead, you order from a menu, the kitchen prepares it, and they give you the food. An API is like that menu—it tells other programs what services are available and how to request them.

Real-World API Examples

Google Maps API: When Uber wants to show you a map in their app, they don't build their own map. They use Google's API to request map data, directions, and location information. Uber sends a request: "Show me a map of Bangalore with directions from my location to this address." Google's API responds with the map image.

Weather API: When you check weather in the morning, many apps (news apps, calendar apps, fitness apps) use the same weather API to get data. Your phone's weather app sends a request: "What's the weather in Mumbai right now?" The weather service API responds with temperature, humidity, wind speed.

Spotify API: Developers can build apps that play music using Spotify's API. An app might request: "Play this song," "What's the user's current playlist?" Spotify's API handles the actual music streaming.

Twitter/X API: Many third-party apps let you post tweets without opening Twitter. They use Twitter's API to send your tweet.

How APIs Work: Request & Response

APIs work like a conversation:

Step 1: **Your App Makes a Request** Your app says: "Hey API, I need this information!" using a specific format the API understands. Step 2: **The API Receives the Request** The API server receives your request and understands what you're asking for. Step 3: **The API Processes the Request** The API's server does the work: fetching data from a database, running calculations, etc. Step 4: **The API Sends a Response** The API sends back the data you requested in a standard format. Step 5: **Your App Uses the Data** Your app takes the data and does something with it (displays it, processes it, etc.).

REST APIs: The Most Common Type

REST stands for "Representational State Transfer." It's the most popular way to build APIs.

In a REST API, you make requests using HTTP methods: GET: "Give me data" (like reading a book). POST: "Here's new data, save it" (like writing in a notebook). PUT: "Update existing data" (like erasing and rewriting). DELETE: "Remove this data" (like tearing out a page).

Example REST API request:

GET /api/weather?city=Mumbai
This asks: "Give me weather data for Mumbai"
      

The API might respond:

{
  "city": "Mumbai",
  "temperature": 28,
  "humidity": 75,
  "condition": "Partly Cloudy"
}
      

API Endpoints

An API endpoint is a specific URL that does one thing. Like:

GET /api/users - Get a list of all users. GET /api/users/123 - Get information about user with ID 123. POST /api/users - Create a new user. DELETE /api/users/123 - Delete user 123.

Each endpoint has a specific purpose.

API Authentication: Keeping Data Secure

You can't just access any API. Most APIs require authentication (proof that you're allowed to use it). Common methods:

API Keys: A secret string that identifies your app. Like: sk_live_abc123xyz789. You include it in your request: GET /api/data?apikey=sk_live_abc123xyz789

OAuth: A more secure method where you log in with your account (like "Log in with Google"). The app gets permission to access your data without ever seeing your password.

Rate Limiting

APIs limit how many requests you can make. For example: "You can make 1000 requests per hour." This prevents:

Overloading the server, Abuse (someone using the API maliciously), Ensuring fair usage for all developers.

If you exceed the limit, the API says: "You've made too many requests. Try again later."

JSON: The API's Language

Most APIs use JSON (JavaScript Object Notation) to format data. It's human-readable and easy for computers to parse.

JSON example:

{
  "name": "Raj",
  "age": 15,
  "city": "Bangalore",
  "interests": ["coding", "gaming", "music"]
}
      

Instead of messy text, JSON is organized in key-value pairs.

Error Handling

Sometimes API requests fail. The API responds with error codes:

400 Bad Request: Your request was wrong (maybe wrong format). 401 Unauthorized: You didn't provide valid authentication. 403 Forbidden: You're not allowed to access this resource. 404 Not Found: The resource doesn't exist. 500 Server Error: Something went wrong on the server.

Building Your Own API

Advanced students can build their own API using frameworks like Flask (Python) or Express (JavaScript). A simple API might:

Have a database storing student records, Provide endpoints to get, add, update, delete records, Authenticate requests with an API key, Return data in JSON format.

This teaches backend development and how the "server-side" works.

Public vs Private APIs

Public APIs: Anyone can use them (with proper authentication). Examples: OpenWeather, NASA API, GitHub API. Private APIs: Only your own apps can use them. A company might have a private API for communication between their internal apps.

API Documentation

Good APIs have detailed documentation explaining: What endpoints are available, What parameters each endpoint accepts, What data is returned, What error codes might occur, Example requests and responses, Rate limits and authentication requirements.

Reading API documentation is a crucial skill for developers.

Using APIs in Real Projects

Once you understand APIs, you can build amazing projects: Weather App: Use a weather API to show current and forecast weather. Movie App: Use IMDb or TheMovieDB API to search and display movies. Cryptocurrency App: Use cryptocurrency APIs to show Bitcoin and Ethereum prices. Social Media Analytics: Use Twitter/Instagram APIs to analyze your social media.

Summary

APIs are how modern software communicates. They use request-response cycles with methods like GET, POST, PUT, DELETE. REST APIs are the most common. Authentication protects access. JSON formats the data. Rate limits prevent abuse. With API knowledge, you can build applications that use powerful services without building everything from scratch yourself. APIs are fundamental to modern web and mobile development!

Thinking Like a Computer Scientist

Before we dive into Introduction to APIs, let me tell you something important. The most valuable skill in computer science is not memorising facts or typing fast. It is a way of THINKING. Computer scientists look at big, messy, confusing problems and break them down into small, simple steps. They find patterns. They test ideas. They are not afraid of making mistakes because every mistake teaches them something.

Right now, India has the second-largest number of internet users in the world — over 900 million people! And the companies building the apps and services these people use need millions more computer scientists. Many of them will be people your age, learning these concepts right now. This chapter on introduction to apis is one more step on that journey.

Building a Web Page Step by Step

Let us build a simple web page together. Think of HTML as the skeleton (structure), CSS as the skin and clothes (appearance), and JavaScript as the muscles (behaviour).

<!DOCTYPE html>
<html>
<head>
  <title>My India Page</title>
  <style>
    body { font-family: Arial; background: #f0f8ff; }
    .card { background: white; padding: 20px; border-radius: 10px;
            box-shadow: 0 2px 8px rgba(0,0,0,0.1); margin: 20px; }
    h1 { color: #FF6600; }
    button { background: #25D366; color: white; padding: 10px 20px;
             border: none; border-radius: 5px; cursor: pointer; }
  </style>
</head>
<body>
  <div class="card">
    <h1>Welcome to My Page!</h1>
    <p id="message">Click the button to see magic</p>
    <button onclick="changePage()">Click Me!</button>
  </div>
  <script>
    function changePage() {
      document.getElementById('message').textContent =
        'Namaste! You just used JavaScript! 🎉';
    }
  </script>
</body>
</html>

This single file demonstrates all three web technologies working together. The HTML creates the structure (heading, paragraph, button), the CSS inside the <style> tag makes it look beautiful (rounded cards, colours, shadows), and the JavaScript inside the <script> tag makes the button actually DO something. When you click the button, JavaScript finds the paragraph by its ID and changes its text. This is exactly how real websites like Flipkart and Zomato work — just with thousands more lines of code!

The UPI Revolution as a CS Case Study

Before UPI, sending money meant NEFT forms, IFSC codes, 24-hour waits, and fees. UPI abstracted all that complexity behind a simple VPA (Virtual Payment Address like name@upi). This is the power of abstraction — hiding complex implementation behind a simple interface. Under the hood, UPI uses encryption (security), API calls (networking), database transactions (data management), and load balancing (distributed systems). Every CS concept you learn shows up somewhere in UPI's architecture.

Variables, Loops, and Making Decisions

Programs become powerful when they can remember things, repeat actions, and make choices. These three abilities — variables, loops, and conditionals — are the building blocks of ALL software:

# VARIABLES — the computer's memory
name = "Priya"            # Stores text (string)
age = 12                  # Stores a whole number (integer)
height = 4.8              # Stores a decimal (float)
likes_cricket = True      # Stores True or False (boolean)

# CONDITIONALS — making decisions
if age >= 13:
    print(f"{name} is a teenager!")
elif age >= 6:
    print(f"{name} is in school!")
else:
    print(f"{name} is very young!")

# LOOPS — repeating actions
print("
Counting to 10:")
for number in range(1, 11):
    if number % 2 == 0:
        print(f"  {number} is EVEN")
    else:
        print(f"  {number} is odd")

# REAL-WORLD EXAMPLE: Calculate your cricket batting average
scores = [45, 72, 0, 88, 23, 105, 34]
total = sum(scores)
innings = len(scores)
average = total / innings
print(f"
Batting average: {average:.1f} runs per innings")

Notice how the code reads almost like English? That is Python's superpower — it was designed to be readable. The indentation (spacing) is not just for looks; Python REQUIRES it to know which code belongs inside an if block or a for loop. In India, Python is now taught from Class 6 in many CBSE schools as part of the NEP 2020 curriculum.

Inside the Tech Industry

Let me give you a glimpse of how introduction to apis is applied in production systems at India's top tech companies. At Flipkart, during Big Billion Days, the system handles over 15,000 orders per SECOND. Every one of those orders involves inventory checks, payment processing, fraud detection, warehouse assignment, and delivery scheduling — all happening simultaneously in under 2 seconds. The engineering behind this is extraordinary.

At Razorpay, which processes payments for hundreds of thousands of businesses, the system must handle concurrent transactions while ensuring exactly-once processing (you cannot charge someone's card twice!). This requires distributed consensus algorithms, idempotency keys, and sophisticated error handling. When you see "Payment Successful" on your screen, dozens of systems have communicated, verified, and recorded the transaction in milliseconds.

Zomato's recommendation engine analyses your past orders, location, time of day, weather, and even what people similar to you are ordering to suggest restaurants. This involves machine learning models trained on billions of data points, real-time inference systems, and A/B testing frameworks that compare different recommendation strategies. The "For You" section on your Zomato app is the result of some seriously sophisticated computer science.

Even India's public infrastructure uses these concepts. IRCTC's Tatkal booking system handles millions of simultaneous users at 10 AM, requiring load balancing, queue management, and optimistic locking to prevent overbooking. The Delhi Metro's automated signalling system uses real-time algorithms to maintain safe distances between trains. Traffic management systems in cities like Bangalore and Pune use computer vision to analyse traffic density and optimise signal timings.

Key Vocabulary

Here are important terms from this chapter that you should know:

🔬 Experiment: Measure Algorithm Speed

Here is a practical experiment: write two Python programs — one that uses a list and one that uses a dictionary — to check if a word exists in a collection of 10,000 words. Time both programs. You will discover that the dictionary version is dramatically faster (O(1) vs O(n)). Now try it with 100,000 words, then 1,000,000. Watch how the difference grows exponentially. This single experiment will teach you more about data structures than reading a textbook chapter.

Connecting the Dots

Introduction to APIs does not exist in isolation — it connects to everything else in computer science. The concepts you learned here will show up again and again: in web development, in AI, in app building, in cybersecurity. Computer science is like a giant jigsaw puzzle, and each chapter you complete adds another piece. Some day, you will step back and see the complete picture — and it will be beautiful.

India is producing the next generation of global tech leaders. Students from IITs, NITs, IIIT Hyderabad, and BITS Pilani are founding companies, leading engineering teams at Google and Microsoft, and solving problems that affect billions of people. Your journey through these chapters is the same journey they started on. Keep building, keep experimenting, and most importantly, keep enjoying the process.

Crafted for Class 4–6 • Web Development • Aligned with NEP 2020 & CBSE Curriculum