Блок 3 · Урок 1 из 4

API и эндпоинт

Как одна программа просит данные у другой — тот же HTTP, что в блоке 1, но ответ не страница для человека, а данные для программы.

⏱ ≈ 8 минут 🔌 программы общаются 🎯 цель: понимать, что значит «дёрнуть API» и «добавить эндпоинт»

Зачем это вам

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

Главная идея

Вход для программ, а не для людей

API (Application Programming Interface, программный интерфейс1) — это набор правил, по которым одна программа обращается к другой. Эндпоинт (endpoint, «конечная точка»2) — конкретный адрес-«окошко» внутри этого API под определённую операцию.

Вы уже знаете HTTP из блока 1: браузер отправляет запрос с методом (GET, POST…) на URL, сервер возвращает ответ со статус-кодом. API работает точно так же — те же методы, те же URL, те же коды 200/404/500. Единственное отличие: в ответ приходит не красиво оформленная страница для глаз, а данные для кода. Чаще всего это JSON (о нём следующий урок) — структурированный текст, который программа умеет разбирать и использовать.

Эндпоинты выглядят как обычные URL с понятными «адресами»: /users/42, /weather?city=Moscow, /orders. Каждый отвечает строго за свою операцию: один выдаёт данные конкретного пользователя, другой — прогноз погоды, третий — список заказов.

Бывают свой бэкенд-API (ваш сервер для вашего же фронтенда) и внешние API (чужие сервисы, к которым вы подключаетесь: Stripe для оплаты, OpenAI для ИИ, Google Maps для карт). Принцип одинаковый — разница лишь в том, чей это сервер.

📌 Простая проверка: сайт отвечает страницей для человека — API отдаёт данные для программы. Если видите в ответе фигурные скобки {…} вместо HTML — перед вами API.

Аналогия, которую можно пересказать

Окошки в учреждении

«Здание с окошками»— API: единое здание с правилами, как просить у программы
«Окошко с табличкой»— эндпоинт: адрес под конкретную операцию (/users/42)
«Бланк в окошко»— запрос: метод (GET/POST) плюс параметры
«Что выдают в ответ»— данные (обычно JSON), а не страница для человека

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

Запомните одно

API — это «вход для программ»

Сайт показывает страницу человеку; API отдаёт данные другой программе. Эндпоинт — конкретное окошко этого входа: один адрес — одна операция.

Что это даёт на практике

Фраза агента → что он имеет в виду

«Дёрнем этот API» / «сделаем запрос к API»
Отправлю HTTP-запрос на конкретный эндпоинт и получу данные обратно.
«Добавим эндпоинт /orders»
Заведу на сервере новый адрес-окошко, который будет отвечать за заказы.
«Фронт ходит на бэкенд за данными»
Браузерная часть (фронт) запрашивает данные у серверной (бэкенд) через API — не напрямую к базе, а через эндпоинты.
«Это внешний API»
Данные берём у чужого сервиса (погода, оплата, ИИ), а не у своего сервера — подключаемся по тем же правилам HTTP.

API (Application Programming Interface) — набор правил, по которым одна программа обращается к другой.

Эндпоинт (endpoint) — конкретный адрес API под определённую операцию (/products/42).

Запрос к API — обращение к эндпоинту с методом и параметрами; в ответ приходят данные.

Бэкенд-API — API вашего сервера, которым пользуется ваш фронтенд.

Проверьте себя

Четыре вопроса с мгновенной проверкой

1. Что такое API?

2. Что такое эндпоинт?

3. Чем ответ API обычно отличается от обычной веб-страницы?

4. Агент говорит: «фронт ходит на бэкенд за данными». Это значит…

Куда мы идём

Программа курса — 7 блоков