Что такое API простыми словами — объяснение на примере погоды

Когда я впервые услышал слово "API", мне казалось, что это какая-то магия для избранных программистов. Помню, как сидел в кафе, смотрел на ребят с ноутбуками, и думал: "Они явно знают что-то, чего не знаю я".

Сейчас я объясню вам API так, что даже ваш дедушка поймёт. И сделаю это на живом примере — с погодой. Потому что погоду хотят знать все.

Что такое API на самом деле?

API — это Application Programming Interface. Звучит страшно? Расшифруем.

Представьте себе ресторан. Вы — клиент. Кухня — это сервер, где готовят еду. А официант — это API.

Вы не идёте на кухню сами (это было бы странно). Вы сидите за столом, смотрите меню (документацию API), делаете заказ официанту (отправляете запрос), и он приносит вам готовое блюдо (ответ от сервера). Вы даже не знаете, как именно готовят еду — вам просто приносят результат.

Так же работает API в интернете. Вы отправляете запрос, API его обрабатывает, и возвращает вам данные в понятном виде.

Зачем вообще нужны API?

Без API интернет был бы совершенно другим. Вот что они делают:

• Связывают сервисы

  Когда вы заходите на сайт и видите "Войти через Google" — это API.

• Делятся данными

  Погодные приложения не измеряют температуру сами. Они получают её через API метеослужб.

• Автоматизируют задачи

  Боты, скрипты, интеграции — всё это работает через API.

Пример с погодой — как это работает

Допустим, вы хотите показывать на своём сайте погоду в Москве. Вы не станете устанавливать термометр за окном и передавать данные вручную. Вместо этого вы используете API погодного сервиса.

https://api.openweathermap.org/data/2.5/weather?q=Moscow&appid=ВАШ_КЛЮЧ&units=metric

Шаг 4. Получаем ответ

Сервер возвращает данные в формате JSON — универсальный язык для обмена данными:

{
  "weather": [{"description": "ясно"}],
  "main": {
    "temp": 22.5,
    "feels_like": 21.8
  },
  "name": "Moscow"
}

И всё! Вы уже знаете погоду в Москве. Без термометров, без датчиков — просто запрос и ответ.

Как использовать API в реальном проекте

Давайте я покажу, как это выглядит в коде. Вот самый простой пример на JavaScript:

fetch('https://api.openweathermap.org/data/2.5/weather?q=Moscow&appid=ВАШ_КЛЮЧ&units=metric')
  .then(response => response.json())
  .then(data => {
    console.log(`Температура в Москве: ${data.main.temp}°C`);
    console.log(`Ощущается как: ${data.main.feels_like}°C`);
  })
  .catch(error => console.error('Ошибка:', error));

Всё. Три строчки кода — и вы получили погоду.

Какие бывают типы API

Не все API одинаковые. Есть несколько основных:

• REST API (самый популярный)

  Работает через обычные HTTP-запросы. Как в примере с погодой. Простой, понятный, используется везде.

• SOAP API

  Более старый и сложный. Используется в банках, страховых компаниях. Требует больше настроек.

• GraphQL

  Модный и гибкий. Позволяет запрашивать только те данные, которые вам нужны. Не больше и не меньше.

Для начала вам точно хватит REST. Он есть у 90% сервисов.

Где взять API для своих проектов?

Вот несколько классных бесплатных API, чтобы потренироваться:

Я советую начать с TheCatAPI. Просто чтобы увидеть, как легко получать данные и радоваться котикам.

Почему важно понимать API

Если вы разработчик — API ваша повседневность. Без них вы ограничены тем, что можете сделать сами.

• Договариваться с программистами на одном языке

  Понимание API помогает общаться с разработчиками.

• Понимать сроки задач

  Зная, как работают API, легче оценивать время разработки.

• Видеть возможности для автоматизации

  API открывают доступ к данным и функциям всего мира.

Часто задаваемые вопросы

В итоге

API — это не магия. Это просто способ обмена данными. И когда вы поймёте этот принцип, перед вами откроется целый мир возможностей. Начните с погоды — это просто, быстро и наглядно.

Кстати, у нас есть онлайн-конвертер Base64 и другие полезные инструменты. Попробуйте их в деле!