Basic Understanding of API (For Beginners)

 

1. What is an API?

API stands for Application Programming Interface.

👉 In simple terms:
An API allows different software applications to communicate with each other.

2. Simple Real-Life Analogy

Think of an API like a waiter in a restaurant:

• You (user) → place an order
• Waiter (API) → takes request to kitchen
• Kitchen (server) → prepares food
• Waiter → brings response back to you

👉 You don’t go to the kitchen yourself—the API does the work.

3. How APIs Work (Simple Flow)

1. You send a request
2. API processes the request
3. Server responds
4. You receive a response

👉 This is called Request → Response

4. Where APIs Are Used (Everyday Examples)

• Logging in with Google
• Payment systems (Paystack, Flutterwave)
• Weather apps
• Social media sharing
• Google Maps integration
• Chat applications

5. Types of APIs (Basic)

a. Web APIs

Used over the internet
Example: Getting data from a website

b. REST APIs (Most Common)

• Simple
• Uses HTTP (web requests)
• Widely used in modern apps

6. API Methods (Basic)

These are actions you can perform:

• GET → Retrieve data
• POST → Send data
• PUT → Update data
• DELETE → Remove data

7. What is an Endpoint?

An endpoint is a URL where an API is accessed.

Example:

https://api.example.com/users

👉 This is where requests are sent.

8. What is JSON?

JSON stands for JavaScript Object Notation.

👉 It is the format APIs use to send data.

Example:

{
  "name": "John",
  "age": 25
}

9. Simple API Example (JavaScript)

fetch("https://api.example.com/data")
  .then(response => response.json())
  .then(data => console.log(data));

👉 This gets data from an API.

10. API in Web Development

👉 APIs connect:

• Front-end (what users see)
• Back-end (server & database)

Example:

• User clicks → request sent
• API → fetches data
• Website updates

11. Why APIs Are Important

APIs help:

• Save time (no need to build everything from scratch)
• Connect systems easily
• Enable mobile apps and web apps
• Allow integration with third-party services

12. Real-Life Use for Students

Students can use APIs to:

• Build apps that fetch data
• Integrate payment systems
• Connect websites to databases
• Use external services (maps, email, SMS)
• Create modern web applications

13. Simple Summary

👉 API is:

• A bridge between systems
• A way to request and receive data
• A core part of modern software

Power Teaching Line (for your class)

👉 “An API is the messenger that makes different systems talk and work together.”