Лекция «API и вебхуки простыми словами»

Около 55 минут на 16 тем. Прогресс сохраняется, поэтому лекцию можно проходить частями и возвращаться к ней позже.

Начало — да: первые 1 тема открыты сразу, без регистрации. После бесплатной регистрации откроются темы до 2-й — вместе с частью из 42 тестов и монетами за верные ответы. Полная лекция — 99 ₽ навсегда, либо подписка на все лекции платформы от 499 ₽ в месяц.

Шестнадцать тем про то, что происходит под стрелочкой в конструкторе. Первая часть — устройство запроса: четыре части договора (адрес, метод, параметры, ответ), таблица методов со свойствами safe и идемпотентности из RFC 9110, пять классов кодов ответа и разница 401 и 403 с разным ремонтом, ловушка «200 с объектом error в теле» на примере VK API, и пагинация, из-за которой выгрузка приносит ровно 50 строк вместо пяти тысяч. Вторая — ключи: разбор адреса входящего вебхука Битрикс24 по частям, где секретный код лежит прямо в ссылке и уезжает в историю браузера и логи, права создателя вебхука, дата окончания, и современная альтернатива — access token с набором прав и сроком по RFC 6749, ротация refresh token по RFC 9700, категории доступа и режим read-only у Wildberries и Ozon. Третья — вебхук: почему «входящий» и «исходящий» названы с точки зрения портала, структура события с полем auth и application_token, проверка подлинности, которую назначает отправитель (HMAC-подпись в заголовке Stripe-Signature с допуском 5 минут против списка IP-адресов у ЮKassa), правило «ответь 200 быстро, работай потом» с таблицей диагностики доставки, и модель «хотя бы один раз»: окна повторов, негарантированный порядок и журнал идентификаторов событий как единственная защита от дублей. Четвёртая — повторы и лимиты: ключ идемпотентности, у которого имя заголовка различается одной буквой между Stripe и ЮKassa, код 429 с историей от RFC 2616 до RFC 6585 и заголовком Retry-After, три независимых лимита Telegram, и выбор между опросом и вебхуком, где опрос платит за тишину. Пятая — география запроса по закону о персональных данных и порядок чтения документации из пяти шагов. Оговорки источников названы прямо: где числа приблизительны, где практика отрасли, а где норма стандарта.

Нет, и такой цели здесь нет. Написание интеграции остаётся работой разработчика. Задача специалиста по no-code другая: настроить готовый коннектор и починить сценарий, когда он сломается. Для этого нужно понимать, что коннектор отправляет и что получает в ответ, — а это чтение документации, а не программирование. После лекции вы сможете открыть документацию незнакомого сервиса, найти в ней пять нужных разделов в правильном порядке, выбрать метод, выдать ключ с нужными правами и настроить приём вебхука так, чтобы он не выписал второй чек при повторной доставке.

Точные лимиты по методам Wildberries и Ozon, а также цены платформ автоматизации здесь намеренно не приводятся, и это осознанное ограничение. Лимиты и тарифы меняются, доступные сводки расходятся между собой, а устаревшее число в сценарии опаснее его отсутствия: на него полагаются. Числа, которые названы, привязаны к источнику и к дате — предел облачной редакции Битрикс24, окно повторов ЮKassa в 24 часа, окно Stripe в трое суток, допуск подписи в 5 минут, максимальная длина ключа идемпотентности. Там, где значения приблизительны, это сказано прямо: лимиты Telegram официально не публикуются, распространённые числа основаны на опыте сообщества и зависят от возраста бота. Метод же остаётся неизменным, и ему лекция и учит: где в документации искать лимит своего метода и что делать, когда он сработал.