Що таке API простими словами

Офіціант передає замовлення з кухні до столика — метафора роботи API

Ти відкриваєш застосунок погоди — і бачиш, що завтра +25 і сонячно. Але звідки твій телефон це знає? Він же не має метеостанції на балконі. Насправді телефон нікуди не «знає» — він запитує ці дані в чужого сервера. І робить це через API.

API — одне з тих слів, які звучать страшно, а насправді пояснюються за 5 хвилин. Розберімося.

API — це офіціант між тобою і кухнею

API розшифровується як Application Programming Interface — «інтерфейс для взаємодії програм». Звучить сухо. Тому ось найкраща аналогія у світі.

Уяви ресторан:

• Ти — застосунок (наприклад, погода на телефоні)
• Кухня — чужий сервер, де лежать усі дані
• Меню — список того, що можна попросити
• Офіціант — і є API

Ти не йдеш на кухню сам ритися в холодильнику. Ти кажеш офіціанту: «Борщ, будь ласка». Він передає замовлення кухні, а потім приносить тобі готову страву. Тобі не треба знати, як улаштована кухня — лише що просити і чого чекати.

API робить те саме: приймає твій запит, передає його «кухні» (серверу) і повертає відповідь. Чисто, передбачувано, без залізання в чужі нутрощі.

Як це виглядає насправді

Спілкування через API — це діалог із двох реплік:

1. Запит (request): твоя програма стукає на певну адресу — endpoint. Наприклад: «дай погоду для міста Київ».
2. Відповідь (response): сервер повертає дані, зазвичай у форматі JSON — компактному тексті, зрозумілому і людині, і машині:

{
  "city": "Київ",
  "temperature": 25,
  "condition": "sunny"
}

Твій застосунок бере цю відповідь і гарно малює на екрані: «Київ, +25, сонячно». Усе. Оце і є API в дії.

Ти користуєшся API щодня (навіть не помічаючи)

API — не якась екзотика для обраних. Вони всюди:

• 🗺️ Карти на сайті — сайт кав'ярні показує Google Maps через API Google
• 🔑 «Увійти через Google» — кнопка, що логінить тебе без нового пароля, теж працює через API
• 💳 Оплата карткою — магазин не зберігає твою картку, він передає дані платіжному API (Stripe, LiqPay)
• 🌦️ Погода, курси валют, новини — усе це підтягується з чужих API

Кожен застосунок на твоєму телефоні — це не острів. Це вузол, що постійно перемовляється з десятками чужих сервісів. Мовою API.

Ще одна аналогія: розетка

Якщо офіціант — про обслуговування, то розетка — про стандарт.

Тобі байдуже, звідки прийшла електрика — з АЕС, вітряка чи сонячної панелі. Ти просто вставляєш вилку в розетку, бо форма стандартна. API — це така сама розетка для даних: узгоджений «роз'єм», через який будь-яка програма може під'єднатися до сервісу, не знаючи, що там усередині.

Саме тому API називають контрактом: сервіс обіцяє «попросиш ось так — отримаєш ось таке», і поки контракт діє, усе працює.

Як спробувати самому

Найкраще розуміння приходить на практиці. У браузері та JavaScript є вбудований інструмент для запитів до API — Fetch. Ми детально розбираємо його в уроці Fetch API: як зробити запит, отримати JSON і показати дані на сторінці.

Для тренування є безкоштовні відкриті API — наприклад, JSONPlaceholder (фейкові пости й користувачі) чи публічні API погоди. Зробити перший власний запит і побачити, як з чужого сервера прилітають реальні дані — момент, після якого веб перестає бути магією. А щоб зрозуміти, як усе це працює «під капотом», почни з основи: Що таке веб-розробка і як працює інтернет.

Тепер, коли бачиш слово «API» — уявляй офіціанта, який бігає між твоїм застосунком і чужою кухнею. Не страшно й навіть елегантно. 🍽️