Что такое API простыми словами для начинающих с нуля

GET/api/orders

[
  {
    "id": 125,
    "status": "Доставлен",
    "sum": 3500
  },
  {
    "id": 138,
    "status": "В пути",
    "sum": 2100
  }
]

GET /api/recommendations?user_id=125

GET https://api.example.com/rates?currency=EUR&api_key=ВАШ_КЛЮЧ

{
  "currency": "EUR",
  "rate": 91.45
}

GET /api/products/125 — получить данные товара с номером 125;
POST /api/products — создать новый товар.

POST /api/users
Content-Type: application/json
Authorization: Bearer …

Здесь POST — метод, 
/api/users — адрес ресурса, 
Content-Type и Authorization — заголовки с дополнительной информацией.

В теле запроса (body) можно передать данные, например:
{
  "username": "user",
  "email": "test@example.com"
}

HTTP/1.1 200 OK
Content-Type: application/json

А в теле ответа — данные товара:
{
  "id": 125,
  "name": "Ноутбук",
  "price": 89990
}

GET /api/products/125

https://example.com/api/products/125

Здесь:
https:// — протокол;
example.com — хост (доменное имя);
/api/products/125 — путь (path) к ресурсу.

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

app.get('/api/products', (req, res) => {


app.get(
'/api/products',   // endpoint
(req, res) => {}   // обработчик запроса
)
GET — HTTP-метод;
/api/products — путь endpoint;
req — объект входящего HTTP-запроса;
res — объект, через который сервер формирует ответ.

 res.json([
    {
      id: 1,
      name: 'Футболка',
      price: 3500
    },
    {
      id: 2,
      name: 'Джинсы',
      price: 6000
    }
  ]);
});

HTTP/1.1 200 OK
Content-Type: application/json
[
	{
		"id": 1,
		name": "Футболка",
		"price": 3500
	}
] 

Осталось запустить сервер:
app.listen(3000);

Теперь программа может отправить запрос:
GET http://localhost:3000/api/products

и получить список товаров.

@RestController
@RequestMapping("/api/products")
public class ProductController {

    @GetMapping
    public List<Product> getProducts() {
        return List.of(
            new Product(1, "Футболка", 3500),
            new Product(2, "Джинсы", 6000)
        );
    }
}