Что такое API простыми словами: меню ресторана для программ

API — это согласованный список запросов, которые одна программа может сделать к другой, и формат ответов на них.

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

Аббревиатура расшифровывается как «интерфейс прикладного программирования», и от этого перевода понятнее не становится. Поэтому забудем расшифровку и разберёмся на пальцах — на самом деле идея простая и красивая.

Ресторанная аналогия

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

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

Живой пример

Когда приложение показывает погоду, оно почти наверняка не измеряет температуру само. Оно отправляет запрос к API метеослужбы: «дай погоду для Москвы». Сервер метеослужбы отвечает аккуратным сообщением, обычно в формате JSON:

{
  "city": "Москва",
  "temperature": 18,
  "condition": "облачно"
}

Приложению не нужно знать, откуда метеослужба берёт данные, какие у неё спутники и базы. Ему достаточно знать адрес запроса и формат ответа. Это и есть весь договор.

API как контракт

Главное слово здесь — контракт. API обещает: «если ты пришлёшь мне запрос вот в таком виде, я отвечу вот в таком». Пока обе стороны держат своё слово, они могут меняться независимо. Метеослужба может полностью переписать свою внутреннюю кухню — пока формат ответа не меняется, ваше приложение даже не заметит.

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

Из чего состоит запрос

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

Адрес (URL) — куда обращаемся и что именно просим, например /weather?city=Moscow.
Метод — что хотим сделать: GET (получить данные), POST (отправить новые), и другие.
Параметры — уточнения запроса: какой город, какая дата.
Ключ доступа — часто нужен «пропуск», подтверждающий, что вам разрешено пользоваться этим API.

В ответ приходит статус (всё хорошо? не нашлось? нет доступа?) и сами данные.

API повсюду

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

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

Современные программы почти не пишут с нуля — их собирают, соединяя сервисы через API. Понимая эту идею, вы видите устройство цифрового мира: почему в одном приложении есть карты Google, а в другом — оплата через банк; почему «сломался чужой сервис» может уронить ваше приложение; что значит «интегрировать API». Это словарь, на котором говорит вся современная разработка. И в основе — простая мысль: чтобы пользоваться чем-то, не обязательно знать, как оно устроено внутри. Достаточно меню.