API (інтерфейс програмування застосунків / application programming interface) - це набір правил інструкцій, які дозволяють різним програмам взаємодіяти одна з одною. API визначає, які функції або операції може виконати програма, а також формати даних, які вона може використовувати для обміну інформацією з іншими програмами.
Вебзастосунки часто використовують API для спілкування з іншими службами чи програмами та отримання доступу до їхніх функцій. Таким чином, вебзастосунок може використовувати більше ніж один API. Наприклад, соціальна мережа може використовувати API для взаємодії з сервісом публікації повідомлень, іншим API для аутентифікації користувачів і ще іншим API для отримання геолокаційних даних.
Кожен API може мати свої власні правила і формати даних, і вебзастосунок повинен коректно взаємодіяти з кожним API, яке він використовує.
Приклад роботи API
Розглянемо вигаданий API для отримання інформації про казкових тварин, наприклад, "FantasyCreaturesAPI". Це API може повертати дані про різноманітних казкових істот, їхні властивості та характеристики.
Запит на отримання інформації про казкову тваринуВаш вебзастосунок може відправляти запит для отримання даних про конкретну казкову тварину за допомогою HTTP-запиту. Наприклад:
GET https://tseivo.com/creature?name=Dragon
Де "Dragon" - це ім'я казкової тварини, і API повертає інформацію про цю тварину.
Відповідь API:API повертає дані (дає відповідь на запит) у форматі JSON:
{
"name": "Dragon",
"type": "Legendary",
"abilities": ["Fire breathing", "Flight", "Sharp claws"],
"habitat": "Mountain caves",
"description": "Majestic creature with scales and wings, capable of breathing fire."
}
Відповідь містить різні характеристики дракона, такі як тип, здібності, середовище і опис
Останній етап - використання отриманих данихВаш вебзастосунок може використовувати отримані дані для створення карточки з описом казкової тварини, яку користувач може переглядати. Наприклад, ви можете відобразити ім'я, тип, здібності та опис на сторінці вашого вебзастосунку.
Як приклад використання декількох API одночасно - уявіть що вам також потрібне фото цієї казкової тварини. В кінцевому результаті для відображення карточки казкової тварини з її фото та інформацією - нам потрібно використовувати два окремих API.