DEV Community: Kelvin Osagie

How APIs Really Work: A Beginner’s Guide to Building and Understanding Backend Endpoints

Kelvin Osagie — Sun, 07 Dec 2025 22:29:52 +0000

APIs power almost every app we interact with daily, right from logging into your Instagram account to checking your bank balance or just booking a ride. But for beginners, APIs feel invisible. There’s no user interface, no animations, just data moving behind the scenes to attend to your commands.

In this guide, we’ll explore in depth how APIs actually work, what happens inside a backend server when a request comes in, and how to build your first real endpoint using Express.js. By the end of this article, you should understand APIs like a real backend developer.

What Exactly Is an API?

API stands for Application Programming Interface. Basically, it acts as a bridge that allows two systems to communicate. To give you a simple example, imagine a waiter walks up to you at a restaurant. You (the user) place an order, and the waiter (the API) takes that order to the kitchen (the server). Once the kitchen prepares the food, the waiter brings it back to you. And then in technical terms, the Frontend (e.g., React, Vue, HTML) makes a request, the API carries that request to the Backend to process the logic, and then the API returns a response. Almost all APIs communicate using JSON, which is a lightweight data format.

How API Requests Actually Work

When you do something like clicking "Login" on your Instagram or Snapchat, trying to get into your account, your browser compiles the data (usually as JSON) and sends it out, starting a high-speed journey across the internet. First, the Domain Name System (DNS) acts like a digital phonebook, translating the website’s name into an IP address specific to you so the request can locate the correct server. Upon arrival, the request doesn't go straight to the data; it first passes through "middleware" layers—security checkpoints that handle logging and verify your identity—before finally reaching the backend controller. This controller is basically the brain of the operation, processing the business logic and running queries against the database to fetch or verify the information you need.

Once the logic is processed and the database returns the necessary data, the backend then gathers the results into a structured JSON response. This package is sent back across the network to your frontend, which unpacks the information and updates your screen, like logging you in or showing an error message if it doesn't go through. Remarkably, this entire round-trip process—involving network travel, security checks, code execution, and database lookups—is optimized to happen in just a matter of milliseconds, making the interaction feel immediate to the user.

What is a REST API

REST means Representational State Transfer. It’s the standard architecture used by most modern APIs. REST operates using endpoints like:

GET /api/users
POST /api/login
GET /api/products/:id
DELETE /api/posts/12

REST APIs use:
HTTP Methods
GET – Fetch data
POST – Send data
PUT – Update data
DELETE – Remove data
Common Status Codes
200 – OK
201 – Created
400 – Bad Request
404 – Not Found
500 – Server Error

What is an Endpoint

An endpoint is simply a URL + HTTP method that performs an action.
Examples:
Action
Example Endpoint
Fetch all users

GET /api/users
Get a product
GET /api/products/:id
Create account
POST /api/register
Login
POST /api/login

Types of endpoint inputs

Route params: /users/:id
Query params: /search?keyword=api
Body data: { "email": "test@gmail.com" }

Building Your First API Endpoint

Let’s create a simple backend server.
Setup

npm init -y
npm install express

Create a file: server.js
Simple GET Endpoint
const express = require('express');
const app = express();
const PORT = 3000;

app.get('/api/hello', (req, res) => {
  res.json({ message: 'Hello, world!' });
});

app.listen(PORT, () => console.log(`Server running on port ${PORT}`));

How it works:
app.get() → listens for GET requests
/api/hello → endpoint URL
req → incoming request (data coming in)
res → server response (data going out)

POST Endpoint (Sending Data)
app.use(express.json()); // To read JSON body

app.post('/api/register', (req, res) => {
  const { name, email } = req.body;

  res.status(201).json({
    message: 'User created successfully',
    data: { name, email }
  });
});

What Are Middlewares? (Beginner-Friendly)

Middleware = functions that run before your main logic.
Example:
app.use((req, res, next) => {
console.log(${req.method} ${req.url});
next();
});

Uses:
Logging
Authentication
Validating data
Handling CORS
Middleware powers 60% of a backend system.

How APIs Talk to Databases

Endpoint → Controller → Database → Response
Simplified example:
app.get('/api/user/:id', async (req, res) => {
  try {
    const user = await User.findById(req.params.id);
    res.json(user);
  } catch (error) {
    res.status(500).json({ message: 'Server error' });
  }
});

Even though you’re not using a database yet, this pattern appears in every backend.

Testing APIs with Postman or Thunder Client

To test:

GET request
Select GET
Enter: http://localhost:3000/api/hello
Click Send
POST request
Select POST
Enter endpoint
Go to Body → JSON
Add data:
{
  "name": "Kelvin",
  "email": "kelvin@example.com"
}

Testing tools let you test APIs without building a frontend.

To Round This Up

APIs are much more than just code; they are the fundamental backbone of modern backend development, acting as the invisible glue that connects frontends, databases, and third-party services. By mastering the core lifecycle—understanding how specific requests trigger logic at endpoints, how middleware secures the pipeline, and how structured responses close the loop—you move from simply writing functions to architecting robust, scalable systems. This foundational knowledge transforms the backend from a confusing "black box" into a logical, manageable workflow where data flows predictably.

[Boost]

Kelvin Osagie — Thu, 04 Dec 2025 07:31:20 +0000

Frontend vs Backend: The Real Difference and What Beginners Should Focus On

Kelvin Osagie ・ Dec 4

#beginners #career #webdev

Frontend vs Backend: The Real Difference and What Beginners Should Focus On

Kelvin Osagie — Thu, 04 Dec 2025 06:42:43 +0000

Getting into tech can seem really overwhelming and confusing, like you are entering a maze with no actual destination. There are countless programming languages and too many frameworks to count, and an endless number of career paths. But a foundational problem that almost every beginner faces early on is:

Should I go into frontend or backend?

Both are equally important and technical, and require different ways of thinking and problem-solving. In this article, I will be breaking down the real difference between frontend and backend development, the skills you actually need as a beginner, and how to decide which path aligns with your strengths. By the end, you should know exactly where to start.

What Is Frontend Development?

Frontend development is basically everything the user sees and interacts with on a website or web application. Think about it like this: if you've ever interacted with a website, like clicked a button, filled up a form, or watched an animation on a site. That's frontend work.

<div id="app">
  <h1 id="text">Hello, World!</h1>
  <button onclick="changeText()">Click Me</button>
</div>

Some responsibilities frontend developers handle:

Building the visual layouts of websites
Ensuring mobile responsiveness
Managing user interactions (clicks, inputs, and form submission)
Improving accessibility for all users
Connecting the interface to APIs provided by the backend
Frontend is basically where design meets logic. The aim is to
create an interface that is functional, fast, and visually appealing.

*Core technologies to begin with: *
Frontend has a clear and easy learning path that you could follow to gain structure

HTML - Structure of the webpage
CSS / TailwindCSS / Bootstrap - Styling and Layout
JavaScript - Programming Logic
Frontend Frameworks - React (most popular), Vue, or Angular.

These tools help you build everything, from a simple landing page to an interactive dashboard. Frontend would be a really good fit for you if you like visual and viable results, like creativity mixed with logic. It deals with a lot of designing and improving the user experience, so you should consider all that before getting into it.

What is Backend Development?

Backend development powers the behind-the-scenes logic that users never really see. You can think of it just like a human with his/her backbone that is deeply connected to the brain, which you can't see with the naked eye, but is a vital part of the system. Every time you log in, save data, make a payment, or access your account, a backend server handles these functionalities.

const express = require("express");
const app = express();

app.get("/api/users", (req, res) => {
  res.json([
    { id: 1, name: "Kelvin" },
    { id: 2, name: "Godwin" }
  ]);
});

app.listen(3000, () => {
  console.log("Server running on port 3000");
});

Some responsibilities backend Developers handle:

Managing the database and storing information
Writing APIs for frontend apps to connect to
Handling user authentication (login, signup)
Securing application data
Processing payments
Optimizing server performance

If we call the frontend the “face” of the website or webpage, then the backend is the brain and engine.
Core technologies to begin with:
Backend development requires learning

A Backend Language - Node.js (JavaScript), Python, Go, or Java
A Framework - Express.js (Node), Django/Flask (Python)
Database - MongoDB, PostgreSQL, or MySQL
REST APIs - How apps communicate

These tools are really effective and would help you build anything from small services to large distribution systems. And if you really enjoy problem-solving and logic, then backend is the right place for you. It promotes systems thinking, and you get to work with data and algorithms.

Frontend Vs Development: Clear Differences

Here is an easier way for you to understand the differences:

Aspect	Frontend	Backend
Runs On	Browser	Server
Focus	User interface & experience	Logic, data & system behavior
Tools	HTML, CSS, JavaScript, React	Node.js, Express, Databases
Mindset	Visual + creative	Logical + analytical
Output	Layouts, animations, interactions	APIs, database operations, authentication

Conclusion (Should you learn both?)

Eventually, yes. If you really plan to become a stronger developer, frontend and backend are two essential parts of modern software. One focuses on what users see, the other on how everything works behind the scenes. Both are valuable. Both pay well. And both offer huge career opportunities. But you need to learn one first and gradually grow into the next because the tech world is rapidly evolving, and you would need to evolve with it.