API: подключаем чужие сервисы
Урок 16 из 26 курса «Вайбкодинг: курс с нуля». Бесплатно, с анимациями и тестом.
API: программы болтают
API (программный интерфейс): способ, которым одна программа просит другую что-то сделать. Как официант: ты не идёшь на кухню, а передаёшь заказ, и тебе приносят блюдо. Твой сервер отправляет запрос, сервис отвечает данными. Пример на урок: сайт записи к твоему другу-барберу. Клиент записался, а сайт сам шлёт письмо, берёт предоплату и отвечает на вопросы.
Что можно подключить
Почти всё полезное уже есть в виде API. Почта: Resend или Brevo отправят письмо «ты записан на пятницу». Оплата: Stripe или местный платёжный сервис твоей страны. ИИ: API Anthropic или OpenAI, чтобы бот отвечал клиентам. А ещё погода, карты, перевод. На схеме это блок справа. Проверь, доступен ли сервис и оплата в твоей стране.
Путь ключа
Схема подключения почти всегда одна. 1) Регистрируешься в сервисе. 2) Получаешь API-ключ: пароль для программ (урок про ключи). 3) Кладёшь его в переменные окружения сервера, а не в код. 4) Сервер с ключом обращается к API. 5) Фронтенд обращается только к твоему серверу. Браузер ключа не видит: как на схеме, ключ живёт на сервере.
Вебхук: сервис звонит тебе
Обычно звонишь ты: сервер спрашивает, сервис отвечает. Вебхук (webhook) наоборот: сервис сам стучится на адрес твоего сервера, когда что-то случилось. Пример: клиент оплатил стрижку, платёжный сервис шлёт вебхук «оплата прошла», и сервер отмечает запись оплаченной. Это пунктирная стрелка на схеме. Проверяй подпись вебхука: так сервер убедится, что пишет правда сервис, а не шутник.
Доки и тестовый режим
Документация (доки): инструкция сервиса, как пользоваться его API. Дай агенту ссылку на доки и попроси делать по ним: так меньше выдумок. Начинай в тестовом режиме: у платёжных сервисов есть песочница, где оплата ненастоящая и деньги не списываются. Пройди весь путь: запись, письмо, оплата, вебхук. Работает? Только тогда переключай на боевые ключи, то есть настоящие.
Проверь себя
- Где должен лежать API-ключ платёжного сервиса?
Правильный ответ: В переменных окружения на сервере. Ключ на сервере не виден браузеру. Фронтенд просит твой сервер, а уже сервер с ключом обращается к API. - Что такое вебхук?
Правильный ответ: Сервис сам обращается к твоему серверу, когда что-то случилось. Обычно спрашивает твой сервер. Вебхук наоборот: сервис сам сообщает, например «оплата прошла». - С чего начать подключение оплаты?
Правильный ответ: С тестового режима, где деньги не списываются. В песочнице можно сколько угодно проверять весь путь без риска. Боевые ключи включай, когда всё работает.
← База данных и вход в аккаунт Фоновые задачи и расписание →