Что такое API — на пальцах, и почему ты дёргаешь сотню их каждый день

Смотри, неожиданная штука: ты пользуешься десятками чужих программ, ни разу не заходя к ним внутрь. Приложение с погодой не считает погоду само — оно спрашивает чужой сервер. Кнопка «войти через Google» не знает твой пароль — она спрашивает Google. Всё это происходит через одну вещь, которая называется API. И как только ты её почувствуешь, половина «магии» приложений станет понятной.

Что это такое в одной фразе

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

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

Расшифровка (она тебе не пригодится, но пусть будет): Application Programming Interface — «интерфейс для программ». То есть способ, которым одна программа общается с другой.

Как это работает по шагам

Любой вызов API — это короткий диалог: твоя программа отправила запрос, чужой сервер прислал ответ.

1. Твой код формирует запрос. В нём адрес — куда стучимся (его называют эндпоинт, например api.погода.рф/сейчас?город=Москва), и что именно просим.
2. Запрос летит на чужой сервер по интернету, обычным HTTP — тем же протоколом, что грузит сайты в браузере.
3. Сервер делает работу — лезет в свою базу, считает, проверяет — и формирует ответ.
4. Ответ возвращается к тебе — почти всегда в виде JSON: аккуратный текст вида {"температура": 17, "ветер": 4}, который твоя программа легко разбирает.

Весь фокус в том, что тебе не нужно знать, как сервер посчитал погоду. Тебе важно только меню (что просить) и формат тарелки (что придёт). Это и есть сила API: ты используешь чужую сложную работу, не вникая в неё.

Почему это важно тебе

Как только ты собираешь хоть что-то живое, ты собираешь это из чужих API, как из кубиков. Нужна карта в приложении — берёшь API карт. Нужно отправить письмо — API почты. Нужно, чтобы твой бот отвечал по-человечески — дёргаешь API языковой модели. Ты не пишешь всё с нуля — ты соединяешь готовые окошки.

Поэтому первое настоящее умение вайб-кодера — не «написать алгоритм», а прочитать чужую документацию и подключиться. Какой адрес, какой ключ, что придёт в ответе. Звучит скучно, но именно это превращает идею в работающую штуку за вечер. Когда дойдёшь до практики — посмотри отдельный разбор, как подключить API к проекту по шагам.

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

Чем API отличается от вебхука

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

Где ты встретишь API первым делом

Скорее всего — когда захочешь добавить в свой проект что-то, что не хочется писать руками: оплату, карты, отправку сообщений, ответ от ИИ. Хорошая новость — для тренировки есть куча бесплатных API без оплаты и сложной регистрации. С них и стоит начать: подключил погоду или курсы валют — и сразу видно, как кубики складываются в приложение.

Вопрос: API — это сайт или программа?

Ни то, ни другое. Это интерфейс — набор правил и адресов, по которым к программе можно обратиться. У сайта интерфейс для людей (кнопки, картинки), у API — интерфейс для других программ (запросы и JSON-ответы). Часто за тем же сервисом есть и сайт для людей, и API для программ.

Вопрос: мне нужно знать программирование, чтобы пользоваться API?

Чуть-чуть. Сам вызов — это пара строк кода или даже одна команда в терминале. Сегодня тебе и их часто пишет ИИ-агент: ты говоришь «подключи вот этот API погоды», он формирует запрос. Но понимать, что такое эндпоинт, ключ и JSON-ответ, всё равно полезно — иначе непонятно, что чинить, когда не работает.