VVERSUSSDigital guide
English
Головна / Software
Software·Sep 13, 2026·Редакція Versuss

Що робить API

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

Ілюстрація до статті: Що робить API

Оновлено:

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

Запити, ендпоінти та відповіді

API — Application Programming Interface, програмний інтерфейс. Найзрозуміліша аналогія — меню й офіціант у ресторані. Вам не потрібно заходити на кухню й знати, як готують страву: ви обираєте з меню, робите замовлення зрозумілою офіціанту мовою й отримуєте результат. Меню — це документація API, замовлення — запит, страва — відповідь. Кухня може змінити рецепти чи обладнання, і поки меню лишається тим самим, для вас нічого не змінюється.

У програмуванні API — це набір операцій, які надає система, з описом, які дані вона приймає і які повертає. Бувають API бібліотек (функції, які викликає ваш код), операційних систем (як програма просить відкрити файл або вивести вікно) і, найчастіше в розмовах, вебові API, через які програми спілкуються по мережі.

Один запит до API від початку до кінця
Один запит до API від початку до кінця · Схема: Versuss

Як виглядає вебовий API

Більшість сучасних вебових API працюють поверх HTTP і повертають дані у форматі JSON. Запит виглядає приблизно так:

GET https://api.weather.example/v1/forecast?city=Kyiv
Authorization: Bearer abc123

А відповідь — так:

{
  "city": "Kyiv",
  "temperature": 21.5,
  "condition": "partly cloudy",
  "updated": "2026-09-20T08:00:00Z"
}

Адреса визначає, що саме запитують (ресурс), метод HTTP — дію (GET прочитати, POST створити, PUT оновити, DELETE видалити), заголовок авторизації — хто запитує, а відповідь — структуровані дані, які програма легко розбере. Такий стиль називають REST. Є й інші: GraphQL дозволяє клієнту описати, які саме поля йому потрібні, за один запит; gRPC використовує компактний двійковий формат для швидкого обміну між сервісами; вебхуки працюють навпаки — сервер сам надсилає запит вам, коли щось сталося.

  • Застосунок погоди на телефоні не має власних метеостанцій — він запитує API метеослужби.
  • Кнопка «Увійти через Google» — це API авторизації (OAuth), який підтверджує вашу особу без передачі пароля сайту.
  • Оплата карткою в інтернет-магазині відбувається через API платіжного провайдера; магазин не бачить номера картки.
  • Карта на сайті доставки — вбудований через API картографічний сервіс.
  • Розумна лампочка вмикається з телефона через API виробника в хмарі.
  • Мобільний застосунок банку — по суті, інтерфейс до банківського API; вебсайт банку використовує той самий API.

Ключі, ліміти й версії

Сервіси мають знати, хто до них звертається, тож видають API-ключі або токени. Ключ — це фактично пароль програми: його не публікують у відкритому коді й не вставляють у сторінку, яку бачить браузер. Щоб одна програма не перевантажила систему, вводять ліміти запитів (наприклад, 1000 на годину), а перевищення повертає код 429. Оскільки клієнти залежать від формату відповідей, API версіонують (/v1/, /v2/): стара версія працює, поки клієнти переходять на нову. «Сервіс закрив API» означає саме розрив цієї домовленості — сторонні застосунки, побудовані на ньому, перестають працювати.

Як почати працювати з першим API

  • Якщо ви даєте застосунку доступ до облікового запису через API, читайте, які саме права він запитує, і відкликайте невикористовувані в налаштуваннях сервісу.
  • API-ключі — це секрети. Зберігайте їх у змінних середовища чи менеджері секретів, не в репозиторії.
  • Обираючи сервіс для проєкту, дивіться на його документацію API, стабільність версій і ліміти — від цього залежить, скільки ви зможете на нього спиратися.
  • Для автоматизації рутинних задач більшість сервісів мають API, який дозволяє обійтися без клікання в інтерфейсі.
  • Логуйте помилки відповідей (4xx, 5xx): вони точно кажуть, хто винен — запит чи сервер.

Часті запитання

Чим API відрізняється від сайту?

Сайт повертає HTML для людини, API — структуровані дані для програми. Часто це один і той самий сервер із двома «фасадами».

Чи можу я скористатися API без програмування?

Так: інструменти на кшталт Postman або curl дозволяють надсилати запити вручну, а сервіси автоматизації (Zapier, Make, n8n) з’єднують API без коду.

Що таке відкритий API?

API, задокументований і доступний стороннім розробникам, іноді безкоштовно, іноді за плату або з лімітами. Закритий API використовує лише сам сервіс.

API — це домовленість: ось що можна попросити, ось як просити, ось що отримаєте у відповідь. Усе інше — справа кухні.

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

Схожі статті