What is an API?

Beginner 15 min read Lesson 1 of 6
Imagine this: You are sitting at a restaurant. You look at the menu and tell the waiter, "I want a cheeseburger." The waiter writes it down, goes to the kitchen, and brings you the cheeseburger. You don't need to know how the kitchen works, who cooks the food, or where the ingredients come from.

In the tech world, the Waiter is the API!

So, what is an API?

API stands for Application Programming Interface. It is a set of rules that allows two software applications to talk to each other. Just like the waiter communicates your order to the kitchen, an API takes your request, asks the server/database for the information, and brings the result back to you.

Connecting API to C#

If you know basic C#, you already know what an API is! Think of a C# method:

public string GetUserName(int id)
{
    // Go to the database and find user by id
    return "Ali";
}

This method takes an input (id) and returns an output (string). An API is exactly like this method, but instead of being used inside your own program, it is placed on the internet so anyone in the world can call it using a URL.

Real-World Examples of APIs

  • Weather Apps: When you check the weather on your phone, your app doesn't have its own weather station. It calls a Weather API (like OpenWeatherMap) to get the temperature.
  • Online Payments: When you buy something, the store's website uses an API (like Stripe or PayPal) to process your credit card securely.
  • Login with Google: When you click "Login with Google", the website asks Google's API, "Is this person's password correct?"

Why do we use APIs?

Imagine if every app had to build its own payment system. It would be slow and unsafe. APIs allow developers to reuse existing, secure, and powerful systems built by other companies.

Key Takeaway

An API is a messenger. It takes a request from the client (you), delivers it to the server, and returns the response back to you. You don't need to know how the server works internally!

Back to Lessons Next Lesson
Lessons
Test Your Knowledge - Take Quiz