Что такое API

API — интерфейс взаимодействия

API (Application Programming Interface) — это набор правил, по которым одна программа общается с другой.

Аналогия с розеткой

Розетка — это API. Ты не думаешь о том, как устроена электросеть. Просто вставляешь вилку и получаешь ток.

Любое устройство с вилкой может использовать розетку — потому что есть стандарт.

Виды API

Web API (HTTP)
├── REST  — самый распространённый
├── GraphQL — клиент сам выбирает какие поля нужны
└── gRPC  — высокопроизводительный, между сервисами

Браузерные API
├── fetch() — HTTP-запросы из JS
├── DOM API — управление страницей
└── localStorage — хранение данных

Системные API
├── File System API — работа с файлами
└── OS API — взаимодействие с операционной системой

Зачем нужно API?

1. Изоляция — не нужно знать как работает другая система
2. Стандарт — любой клиент понимает один формат
3. Версионирование — /api/v1/users позволяет менять v2 не ломая старых клиентов