Объяснение вебхуков: как они работают и как безопасно их получать

  1. Главная
  2. Блог
  3. Разработка программного обеспечения

Разработка программного обеспечения

Объяснение вебхуков: Как они работают и как безопасно их получать

Веб-перехватчики позволяют одной системе сообщать другой о том, что что-то происходит, отправляя HTTP-запрос на выбранный вами URL-адрес. Узнайте, чем они отличаются от опросов, как проверять подписи и как выжить при повторных попытках и повторах, с помощью приемника, который мы использовали.

9 мин чтения
Объяснение вебхуков: как они работают и как их безопасно получать

Главное

  • Вебхуки — это запросы HTTP POST, которые провайдер отправляет на ваш URL-адрес при возникновении события, поэтому вам не нужно постоянно спрашивать.
  • Любой может вызвать общедоступный URL-адрес, поэтому проверьте подпись HMAC в необработанном теле с помощью сравнения в постоянное время.
  • Отклоняйте старые временные метки, чтобы остановить повторы, и сохраняйте идентификаторы событий, чтобы повторные доставки обрабатывались только один раз.
  • В нашем случае получатель принял действительное событие, проигнорировал его повторную попытку и отклонил измененное тело, неверный секрет и повтор 10-минутной давности.

Вашему приложению необходимо знать, когда платеж прошел успешно, сборка завершена или форма отправлена ​​в другой сервис. Вы можете спрашивать эту службу каждую минуту: «Что-нибудь новое?», но большинство ответов будут «нет». Вебхуки меняют направление: вы даете сервису URL-адрес, и он вызывает вас в тот момент, когда происходит событие.

Чтобы проверить идеи, а не просто описать их, мы написали небольшой получатель и отправитель веб-перехватчика со стандартной библиотекой Python 3.13, запускали оба на одной машине и отправляли на нее действительные, подделанные, воспроизводимые и повторные запросы. Результаты ниже скопированы из этого прогона. Если API в целом для вас новы, сначала прочитайте что такое API.

Что такое вебхук?

Вебхук — это обратный вызов HTTP. Вы регистрируете конечную точку, например https://example.com/hooks/payments, у провайдера и выбираете, какие события вас интересуют. Когда это происходит, поставщик отправляет POST-запрос на этот URL-адрес с телом JSON, описывающим событие. Ваш сервер читает его, проверяет его подлинность, выполняет свою работу и отвечает кодом состояния 2xx.

Люди иногда называют вебхуки «обратными API». При обычном вызове API ваш код задает вопрос, а провайдер отвечает. С помощью вебхука провайдер начинает разговор.

Вебхуки против опросов

Аспект Опрос API Вебхуки
Кто начинает Ваше приложение по таймеру Поставщик, по каждому событию
Задержка До одного интервала опроса Обычно секунды
Ненужные звонки Много пустых ответов Почти нет
Вашему серверу нужен Только исходящий доступ Публичная конечная точка HTTPS
Пропущенные события Редкий; ты спрашиваешь еще раз Возможно, если повторные попытки закончатся

Опрос также позволяет преодолеть ограничения скорости, как объясняется в нашем руководстве по ограничению скорости API. Многие команды используют и то, и другое: вебхуки для повышения скорости и периодическую проверку, которая выявляет все, что было пропущено при неудачной доставке.

Как работает доставка через вебхук

  1. У провайдера происходит событие, например payment.succeeded.
  2. Поставщик создает полезную нагрузку JSON, подписывает ее секретным ключом, доступным только вам, и отправляет ее POST на ваш URL-адрес.
  3. Ваша конечная точка проверяет подпись и метку времени, записывает идентификатор события и быстро возвращает 200.
  4. Если ваша конечная точка выходит из строя или истекает время ожидания, провайдер повторяет попытку позже, обычно с увеличивающимися перерывами.

Как выглядит полезная нагрузка

POST /hook HTTP/1.1
Content-Type: application/json
X-Timestamp: 1794500000
X-Signature: b82128c3c09fb40a...

{"id": "evt_1", "type": "payment.succeeded", "amount": 500}

Значения временной метки и подписи, приведенные выше, представляют собой сокращенные иллюстрации. Имена заголовков различаются в зависимости от поставщика, но большинство из них отправляют идентификатор события, тип события, метку времени и подпись. В нашем руководстве по Python JSON рассматривается безопасный анализ тела.

Подписание и проверка запросов

URL-адрес вашего веб-перехватчика является общедоступным, поэтому любой, кто узнает его, может отправлять ложные события, такие как ложное «платеж успешен». Стандартной защитой является подпись HMAC. Поставщик вычисляет HMAC SHA-256 метки времени и необработанного тела, используя общий секрет, и вы пересчитываете его на своей стороне:

import hmac, hashlib, time

SECRET = b"whsec_demo_only"   # load from an environment variable in real code

def sign(body: bytes, ts: str) -> str:
    return hmac.new(SECRET, f"{ts}.".encode() + body, hashlib.sha256).hexdigest()

def verify(body: bytes, ts: str, sig: str) -> bool:
    if not ts.isdigit() or abs(time.time() - int(ts)) > 300:
        return False                      # stale or missing timestamp
    return hmac.compare_digest(sign(body, ts), sig)

Важны три детали:

  • Используйте необработанные байты тела. Если платформа сначала анализирует и повторно сериализует JSON, интервал или порядок ключей могут измениться, и подпись не будет совпадать.
  • Сравнение за постоянное время. hmac.compare_digest занимает одинаковое время независимо от того, отличается ли первый или последний символ, что предотвращает атаки по времени. Обычный == может остановиться при первом несоответствии.
  • Не допускайте попадания секрета в код. Сохраните его в переменных среды или в менеджере секретов и меняйте его в случае утечки.

Результаты наших испытаний

Мы запустили приемник на локальном порту и отправили шесть видов запросов:

1 valid:                   (200, 'ok')
2 same event again (retry): (200, 'duplicate ignored')
3 tampered body:           (401, 'bad signature')
4 wrong secret:            (401, 'bad signature')
5 replay 10 min old:       (400, 'stale timestamp')
processed events: ['payment.succeeded', 'order.created']

В случае подделки мы подписали тело с помощью "amount": 500, а затем изменили его на 5000 при передаче. Подпись больше не совпадала, поэтому запрос был отклонен. Подпись, сделанная с использованием разгаданного секрета, провалилась таким же образом. Всего было обработано только два события, хотя запросов поступило больше. Коды состояния соответствуют обычному значению HTTP, как указано в нашей шпаргалке по кодам состояния HTTP.

Защита от повтора

Действительная подпись доказывает, что запрос создал поставщик, но не подтверждает его свежесть. Злоумышленник, перехвативший один подлинный запрос, может отправить его позже. Включение метки времени в подписанные данные и отклонение всего, что старше нескольких минут, закрывает этот пробел. Наш запрос десятиминутной давности был отклонен еще до того, как была проверена его подпись. Синхронизируйте часы сервера, иначе подлинные события также могут быть отклонены.

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

Повторные попытки с отсрочкой

Поставщики повторяют попытку, когда ваша конечная точка выходит из строя, истекает время или возвращает статус, отличный от 2xx. Мы смоделировали конечную точку, которая дважды потерпела неудачу, прежде чем восстановиться, с отправителем, который ждал дольше между каждой попыткой:

attempt 1: 500 temporarily down
attempt 2: 500 temporarily down
attempt 3: 200 ok
delivered: True

Наш отправитель каждый раз удваивал время ожидания (50, 100, затем 200 миллисекунд). Настоящие провайдеры используют одну и ту же идею в течение нескольких минут и часов, часто в течение дня или более, затем сдаются и могут отключить конечную точку. Возвращайте 4xx только для запросов, которые вы никогда не примете, например неверных подписей, поскольку некоторые провайдеры перестают повторять попытки при ошибках клиента.

Идемпотентность: обработка каждого события один раз

Повторные попытки означают, что вы будете получать некоторые события более одного раза, например, когда ваш сервер обработал событие, но ответ был потерян. Ваш обработчик должен быть идемпотентным: обработка одного и того же события дважды должна иметь тот же эффект, что и обработка его один раз. Мы сохранили каждый идентификатор события и ответили на повторы фразой «дубликат игнорируется». В рабочей среде идентификаторы следует хранить в таблице базы данных с ограничением уникальности, чтобы две параллельные поставки не могли пройти одновременно.

Отвечайте быстро, работайте позже

Провайдеры ждут вашего ответа всего несколько секунд. Если ваш обработчик отправляет электронные письма, вызывает другие API или запускает отчеты, выполните эту работу после ответа: проверьте, сохраните событие в очереди или таблице, верните 200, а затем обработайте его в фоновом задании. Это позволяет предотвратить истечение времени доставки и избежать шквала повторных попыток в период замедления. События также могут приходить не по порядку, поэтому проверяйте текущее состояние объекта, а не предполагайте, что каждое событие является последним.

Как протестировать вебхуки

  • Выполните модульное тестирование верификатора с известным телом, меткой времени и ожидаемой подписью, а также подделанными и просроченными случаями.
  • Запускайте приемник локально и отправляйте подписанные запросы, как это сделали мы, или используйте CLI или панель мониторинга провайдера для отправки тестовых событий.
  • Используйте инструмент туннелирования, чтобы открыть локальный порт, когда провайдер должен подключиться к вашему ноутбуку; закройте его потом.
  • Тестируйте дубликаты, неупорядоченные события и медленные нижестоящие сервисы, а не только счастливый путь.

Такие инструменты, как Postman, также могут отправлять созданные вручную запросы веб-перехватчиков; см. наше руководство по тестированию API с помощью Postman.

Контрольный список безопасности вебхука

  1. Принимайте только HTTPS.
  2. Проверьте подпись HMAC на необработанном теле с помощью сравнения в постоянное время.
  3. Отклонять временные метки за пределами короткого окна.
  4. Сохраняйте идентификаторы событий и игнорируйте дубликаты.
  5. Сохраняйте секрет в конфигурации, а не в коде, и поддерживайте ротацию.
  6. Быстро отвечайте и обрабатывайте сообщения в фоновом режиме.
  7. Рассматривайте полезную нагрузку как ненадежный ввод; в случае сомнений получите важные сведения из API провайдера.

Итоги

Веб-перехватчики на первый взгляд просты, это всего лишь HTTP POST, но надежный получатель требует некоторых продуманных привычек. Наши тесты показали, что каждый из них работает: подписи прекратили подделку и поддельные отправители, метки времени остановили повторы, идентификаторы событий прекратили двойную обработку, а отсрочка доставки обеспечила доставку через короткий перерыв. Встройте их из первой версии, и веб-перехватчики станут одной из самых надежных интеграций, которые вы используете.

Часто задаваемые вопросы

Что такое вебхук простыми словами?

Вебхук — это автоматический HTTP-запрос, который одна система отправляет на выбранный вами URL-адрес, когда происходит событие, например, успешный платеж. Это избавит вас от многократного опроса на предмет изменений.

В чем разница между вебхуком и API?

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

Как проверить подпись вебхука?

Пересчитайте HMAC, обычно SHA-256, по необработанному телу запроса и временной метке с вашим общим секретом, а затем сравните его с заголовком, используя функцию постоянного времени, такую ​​​​как hmac.compare_digest.

Почему я получаю один и тот же вебхук дважды?

Поставщики повторяют попытку, если не получают вовремя ответа 2xx, даже если вы уже обработали событие. Сохраняйте идентификаторы событий и пропускайте дубликаты, чтобы обработка оставалась идемпотентной.

Какой код состояния должна возвращать конечная точка веб-перехватчика?

Быстро верните код 2xx, как только событие будет проверено и сохранено. Возвращайте 4xx для запросов, которые вы никогда не примете, например, неверные подписи, и 5xx, если вы хотите, чтобы поставщик повторил попытку.

Продолжайте учиться

Работайте с Stack Quora

Нужна помощь с тестированием, WordPress или SEO?

Мы помогаем командам выпускать лучшее программное обеспечение и развивать свои сайты. Расскажите нам, над чем вы работаете, и мы предложим четкий следующий шаг.

Продолжайте читать

Больше руководств по тестирование, искусственный интеллект и современные разработки

Понравилась эта статья? Выберите тему и сразу приступайте к нашим новейшим руководствам.

Искусственный интеллект

Объяснение стратегий разделения RAG: фиксированное, перекрытие, предложение, рекурсивное и заголовки, измеренное

Стратегии фрагментирования RAG в одном документе с tiktoken 0,14: фиксированный размер, перекрытие, упаковка предложений, рекурсивное разделение и ф…

Читать статью →
Разработка ПО

Объяснение идемпотентности API: проверенные ключи идемпотентности и безопасные повторы

Идемпотентность API, объясненная на примере сервера и клиента Python, которые мы запускали: потеря ответа вызывала двойную оплату без ключа и единст…

Читать статью →
DevOps

Объяснение Git Stash: сохранение, применение, удаление и неотслеживаемые файлы, протестировано

Git stash объясняется с помощью команд, которые мы запускали в Git 2.56: push с сообщением, неотслеживаемые файлы, список и отображение, применение …

Читать статью →
Тестирование ПО

Объяснение парного тестирования: как все пары сокращают 216 тестов до 13, протестированных

Попарное тестирование объясняется с помощью генератора, который мы запускали в Python 3.13: проверка с 216 комбинациями, охватываемыми 13 тестами, п…

Читать статью →
Автоматизация тестирования

Объяснение тестовых двойников: манекен, заглушка, шпион, макет и подделка, с протестированным кодом Python

Двойные тесты объяснены на одном примере Python, запущенном в pytest 9.2: манекен, заглушка, шпион, макет и подделка, когда использовать каждый из н…

Читать статью →
Базы данных и SQL

Объяснение SQL COALESCE: значения по умолчанию, NULLIF, IFNULL против ISNULL и ловушки, протестировано

SQL COALESCE объясняется с помощью запросов, которые мы выполняли в SQLite 3.50: первые ненулевые значения, пустые строки, NULL в математике, NULLIF…

Читать статью →
Базы данных и SQL

Объяснение самосоединения SQL: сотрудник-менеджер, сравнение пар и строк, протестировано

Самосоединение SQL объясняется с помощью запросов, которые мы выполняли в SQLite 3.50: сотрудник и менеджер, заработок больше, чем менеджер, уникаль…

Читать статью →
Разработка ПО

Объяснение оператора расширения JavaScript: распространение против остальных, копии и ошибки, протестировано

Оператор расширения JavaScript, объясненный с помощью кода, который мы запускали на узле 24: массивы, объекты, мелкие копии, остальные параметры, ог…

Читать статью →
Разработка ПО

Объяснение модуля коллекций Python: счетчик, defaultdict, deque и многое другое, протестировано

Коллекции Python объяснены с помощью кода, который мы запускали в Python 3.13: Counter, defaultdict, deque, Nametuple, OrderedDict и ChainMap, а так…

Читать статью →
Искусственный интеллект

Объяснение контекстного окна LLM: токены, ограничения и способы вместить больше, измеренное

Контекстное окно LLM поясняется количеством токенов, которые мы измеряли с помощью tiktoken: слова и токены для прозы, кода и хинди, входные и выход…

Читать статью →
Разработка ПО

Объяснение вебхуков: как они работают и как безопасно их получать

Веб-хуки объясняются с помощью получателя и отправителя, которые мы запускали на Python: push и опрос, подписи HMAC-SHA256, отклонение подделанных и…

Читать статью →
DevOps

Объяснение Git Cherry-Pick: скопируйте нужный вам коммит, безопасно и протестировано

Git Cherry-Pick объяснил это командами, которые мы запускали в Git 2.56: копирование исправления в ветку выпуска, новые хэши и идентификаторы патчей…

Читать статью →
Автоматизация тестирования

Объяснение моментального тестирования: как оно работает, когда помогает, а когда вредит

Тестирование снимков объясняется с помощью pytest и сладкой демонстрации, которую мы запускали: создание снимков, чтение различий после изменения ко…

Читать статью →
Тестирование ПО

Объяснение мутационного тестирования: почему при 100% покрытии все еще не обнаружена наша ошибка

Тестирование мутаций объясняется с помощью небольшого инструмента мутаций, который мы создали и запустили: 14 мутантов, набор тестов со 100%-ным пок…

Читать статью →
Искусственный интеллект

Объяснение быстрого внедрения: как обманывают приложения искусственного интеллекта и как их защитить

Быстрое внедрение, объясненное для разработчиков: прямые и косвенные атаки, почему фильтры ключевых слов не работают (наш тест заблокировал 1 из 4),…

Читать статью →
DevOps

Объяснение DNS-записей: A, AAAA, CNAME, MX, TXT и TTL с реальным поиском

Записи DNS объяснены с помощью выполненных нами поисков: как работает разрешение, A и AAAA, правила CNAME, MX и нулевой MX, TXT для SPF и проверки, …

Читать статью →
DevOps

Объяснение флагов функций: безопасные выпуски, постепенное развертывание и гигиена флагов

Флаги функций объяснены с помощью моделирования развертывания, которое мы провели: типы флагов, процентное развертывание со стабильным хешированием,…

Читать статью →
Автоматизация тестирования

Генерация тестовых данных с помощью Python Faker: реалистичные, повторяемые и безопасные данные

Генерация тестовых данных с помощью Python Faker, запуск и измерение: заполнение повторяющихся данных, локали, уникальные значения, записи в форме д…

Читать статью →
Тестирование ПО

Объяснение тестирования с помощью Shift-Left: находите ошибки раньше, не замедляя работу команды

Сдвиг влево при тестировании объяснил: что это значит, почему ранние дефекты обходятся дешевле, практики от проверки требований до CI-проверок, меня…

Читать статью →
Базы данных и SQL

Объяснение строковых функций SQL: TRIM, SUBSTR, REPLACE, CONCAT и очистка данных

Строковые функции SQL, объясненные с помощью выполненных нами запросов: конкатенация и NULL, TRIM, UPPER и LOWER, SUBSTR и INSTR, REPLACE, заполнени…

Читать статью →
Базы данных и SQL

Объяснение триггеров SQL: триггеры ДО и ПОСЛЕ, журналы аудита и подводные камни

Триггеры SQL объяснены с помощью триггеров, которые мы запускали: ДО и ПОСЛЕ, СТАРЫЙ и НОВЫЙ, журналы аудита, проверка, обновления запасов, условия …

Читать статью →
Разработка ПО

Объяснение модуля Python JSON: дампы, загрузки, пользовательские типы и распространенные ошибки

Модуль Python JSON, объясненный с помощью кода, который мы выполнили: дампы и загрузки, файлы, преобразования типов, даты и десятичные дроби, пользо…

Читать статью →
Разработка ПО

Модули ES против CommonJS: как работает импорт JavaScript в Node.js, протестировано

Модули ES и CommonJS объяснены с помощью кода, который мы запускали в Node.js: синтаксис импорта и экспорта, требование, живые привязки, кэширование…

Читать статью →
Разработка ПО

Объяснение регулярных выражений Python: шаблоны, группы, предварительные просмотры и подводные камни, протестировано

Регулярное выражение Python объясняется с помощью шаблонов, которые мы использовали: поиск против совпадения, поиск, группы и именованные группы, жа…

Читать статью →
Искусственный интеллект

Объяснение структурированного вывода LLM: получение надежного JSON из моделей искусственного интеллекта

Структурированный вывод LLM объясняется проверкой, которую мы проводили в Pydantic: режим и схемы JSON, ограниченное декодирование, способы моделиро…

Читать статью →
DevOps

Объяснение ключей SSH: как они работают, ssh-keygen, Ed25519 и безопасные привычки

Ключи SSH объяснены ключами, которые мы сгенерировали: открытые и закрытые ключи, ssh-keygen, Ed25519 и RSA, отпечатки пальцев, парольные фразы, ssh…

Читать статью →
DevOps

Объяснение HTTP-кэширования: Cache-Control, ETag и ответы 304, с живым тестом

Объяснение HTTP-кеширования на небольшом сервере, который мы запускали: директивы Cache-Control, максимальный возраст, отсутствие кэша и отсутствие …

Читать статью →
Автоматизация тестирования

Объяснение тестирования контрактов API: уловите критические изменения до их выпуска

Тестирование контрактов API объясняется с помощью проведенной нами проверки схемы: что такое контракт, контракты, управляемые потребителем, Pact, Op…

Читать статью →
Тестирование ПО

Объяснение тестирования на основе рисков: оцените риски, постройте матрицу и протестируйте то, что имеет значение

Тестирование на основе рисков объясняется шаг за шагом: выявление рисков, оценка вероятности и воздействия, построение матрицы рисков, сопоставление…

Читать статью →
Базы данных и SQL

Объяснение ограничений SQL: NOT NULL, UNIQUE, CHECK и FOREIGN KEY, протестировано

Ограничения SQL объяснены с помощью проведенных нами тестов: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY и FOREIGN KEY, лазейки NULL, настройка внешне…

Читать статью →
Базы данных и SQL

Объяснение функций даты SQL: добавление, сравнение и группировка дат без ошибок

Функции даты SQL, объясненные с помощью запросов, которые мы выполняли: добавление интервалов, сюрпризы в конце месяца, различия в датах, ловушка МЕ…

Читать статью →
Разработка ПО

Объяснение Python asyncio: асинхронность, ожидание, сбор и группа задач с реальным временем

Python asyncio объяснен с помощью кода, который мы запланировали: сопрограммы, ожидание, сбор, TaskGroup, обработка ошибок, тайм-ауты, ограничение п…

Читать статью →
Разработка ПО

Debounce против Throttle в JavaScript: как они работают, когда использовать каждый, протестировано

Сравнение Debounce и Throttle в JavaScript объясняется с помощью таймингов, которые мы измеряли в Node.js: как каждый из них работает, простые реали…

Читать статью →
Разработка ПО

Объяснение менеджеров контекста Python: оператор with, contextlib и реальное использование

Контекстные менеджеры Python объяснили с помощью кода, который мы запускали: как работает, __enter__ и __exit__, contextlib.contextmanager, подавлен…

Читать статью →
Искусственный интеллект

Объяснение температуры LLM и Top-p: как модели ИИ выбирают свое следующее слово

Температура LLM и top-p объяснены с помощью моделирования, которое мы провели: как изменяются вероятности, что сохраняет top-p, рекомендуемые настро…

Читать статью →
DevOps

Объяснение YAML: синтаксис, проблема Норвегии и другие ловушки, которые мы тестировали

YAML объясняется с помощью теста парсера: базовый синтаксис, списки и карты, проблема Норвегии, версии, превращающиеся в числа с плавающей запятой, …

Читать статью →
DevOps

Объяснение Cron Jobs: синтаксис, реальные расписания и ошибки, которые их нарушают

Задания Cron объясняются графиками, которые мы проверили: пять полей, операторы, реальные примеры, ловушка дня месяца ИЛИ дня недели, проблемы окруж…

Читать статью →
Искусственный интеллект

Объяснение галлюцинаций искусственного интеллекта: почему языковые модели все выдумывают и как их уменьшить

Галлюцинации ИИ объяснили: что это такое, почему языковые модели их создают, распространенные типы, как уменьшить их с помощью заземления и подсказо…

Читать статью →
DevOps

Объяснение переменных среды: файлы .env, секреты и правильно выполненная конфигурация

Переменные среды объясняются на примерах Python, которые мы запускали: их чтение и установка, почему каждое значение является строкой, файлы .env, н…

Читать статью →
Разработка ПО

Объяснение ограничения скорости API: алгоритмы, заголовки и обработка ошибок 429

Ограничение скорости API объясняется с помощью проведенного нами моделирования: сегмент токенов, фиксированное окно, скользящее окно, 429 ответов, з…

Читать статью →
Автоматизация тестирования

Издевательство в Python: unittest.mock, патч и ошибки, из-за которых тесты лгут

Издевательство на Python с помощью unittest.mock, протестировано: Mock и return_value, Side_effect, исправление использования имени, спецификация и …

Читать статью →
Тестирование ПО

Объяснение покрытия кода: покрытие линий или ветвей и что на самом деле означает 100%

Покрытие кода объяснено с помощью реального запуска покрытия.py: покрытие строк, ветвей и условий, чтение отчета, почему 100%-ное покрытие все еще м…

Читать статью →
Базы данных и SQL

DELETE, TRUNCATE и DROP в SQL: различия, откат и когда использовать каждый из них

Объяснение DELETE, TRUNCATE и DROP на примере протестированного SQL: что каждый из них удаляет, откат, триггеры, сброс идентификаторов, скорость и ч…

Читать статью →
Базы данных и SQL

Объяснение представлений SQL: создавайте, используйте и избегайте ловушек, с примерами

Представления SQL, объясненные с помощью запросов, которые мы выполняли: создание представления, результаты в реальном времени, скрытие столбцов, пр…

Читать статью →
Разработка ПО

Интерфейс TypeScript и тип: реальные различия, протестированные с помощью компилятора

Интерфейс TypeScript против типа, проверенный реальным компилятором: что могут делать оба, что может делать только один, слияние объявлений, расшире…

Читать статью →
Разработка ПО

Объяснение Python *args и **kwargs: гибкие функции с понятными примерами

Python *args и **kwargs, объясненные с помощью кода, который мы запускали: упаковка и распаковка, порядок параметров, аргументы только по ключевым с…

Читать статью →
Разработка ПО

Лямбда-функции Python: синтаксис, реальное использование и когда их не следует использовать

Лямбда-функции Python, объясненные с помощью кода, который мы запускали: синтаксис, сортировка с помощью ключа, карты и фильтра, замыкания, ловушка …

Читать статью →
Искусственный интеллект

Что такое ИИ-агенты? Как они работают: можно запустить простой цикл агента

Что такое агенты ИИ? Простое руководство по циклу агента, инструментам, памяти и ограничениям, с небольшим циклом Python, который мы запустили, реал…

Читать статью →
DevOps

Мониторинг и наблюдаемость: реальная разница с журналами, метриками и трассировками

Объяснение мониторинга и наблюдаемости: известные и неизвестные сбои, журналы, метрики и трассировки, пошаговое руководство по инцидентам при оформл…

Читать статью →
DevOps

Docker Volumes против Bind Mounts: правильное сохранение данных контейнера

Объяснение томов Docker и монтирования привязки: почему исчезают данные контейнера, именованные тома, монтирование привязки, tmpfs, примеры создания…

Читать статью →
Автоматизация тестирования

TDD против BDD: ключевые различия, одна функция, созданная для обоих способов, и когда использовать каждый

TDD и BDD объясняются с помощью одной функции скидки, созданной в обоих направлениях: красно-зеленый рефакторинг с кодом, который мы запускали, сцен…

Читать статью →
Тестирование ПО

Пользовательское приемочное тестирование (UAT): процесс, контрольный список и реальные примеры

Приемочное тестирование пользователей объяснило: кто его проводит, чем оно отличается от контроля качества, семиэтапный процесс, шаблон тестового сц…

Читать статью →
Базы данных и SQL

Объяснение значений NULL в SQL: IS NULL, COALESCE, NULLIF и ловушки, которых следует избегать

Значения SQL NULL объяснены с помощью запросов, которые мы выполнили: трехзначная логика, IS NULL, COALESCE, NULLIF, как агрегаты, соединения и сорт…

Читать статью →
Базы данных и SQL

Оператор SQL CASE WHEN: синтаксис, реальные примеры и распространенные ошибки

SQL CASE WHEN объяснен с помощью запросов, которые мы выполняли: простые формы и формы для поиска, порядок условий, повороты с помощью SUM, трюки CO…

Читать статью →
Разработка ПО

Что такое JWT? Веб-токены JSON, объясненные на рабочем примере

Что такое JWT? Объяснение JSON Web Tokens: три части: токен, созданный и измененный в коде, который мы запускали, JWT и сеансы, хранилище, токены об…

Читать статью →
Разработка ПО

Объяснение цикла событий JavaScript: стек вызовов, микрозадачи и таймеры с примерами

Цикл событий JavaScript объясняется с помощью кода, который мы запускали: стек вызовов, очереди задач и микрозадач, почему setTimeout 0 не является …

Читать статью →
Разработка ПО

Генераторы Python и объяснение доходности: экономьте память с помощью реальных примеров

Генераторы Python и доходность, объясненные с помощью кода, который мы запускали: как они приостанавливаются и возобновляются, измеряют экономию пам…

Читать статью →
Искусственный интеллект

Что такое вложения? Простое объяснение векторов и косинусного сходства

Что такое вложения? Простое руководство по векторам, косинусному подобию и семантическому поиску с небольшим примером, который мы использовали, общи…

Читать статью →
DevOps

Сине-зеленое и канареечное развертывание: различия, компромиссы и как выбрать

Объяснение сине-зеленого и канареечного развертывания: как каждый из них работает, стоимость, риски и откат, стабильное группирование пользователей,…

Читать статью →
Автоматизация тестирования

Ненадежные тесты: что их вызывает и как их исправить навсегда

Ненадежные тесты объясняются на демонстрациях, которые мы запускали: основные причины, способы подтверждения и диагностики, правильные исправления в…

Читать статью →
Тестирование ПО

Нагрузочное тестирование и стресс-тестирование: различия, метрики и примеры k6

Объяснение нагрузочного и стресс-тестирования: что доказывает каждое из них, тесты на всплески и выдержки, важные метрики, почему средние значения в…

Читать статью →
Тестирование ПО

Тестовый пример и тестовый сценарий: ключевые различия, примеры и когда использовать каждый

Объяснение тестового случая и тестового сценария: четкие определения, параллельная таблица, одна функция сброса пароля, взятая из сценариев в случаи…

Читать статью →
Базы данных и SQL

Оптимизация SQL-запросов: чтение планов выполнения и исправление медленных запросов с указанием времени

Оптимизация SQL-запросов проверена на миллионе строк: читайте планы выполнения, добавляйте правильные индексы, исправляйте неразмещаемые фильтры, ис…

Читать статью →
Базы данных и SQL

SQL UNION против UNION ALL: различия, примеры и проверка производительности

SQL UNION и UNION ALL объяснены с помощью запросов, которые мы выполнили: дубликаты, правила, которым следуют оба, реальная ошибка данных, измеренна…

Читать статью →
Разработка ПО

Учебное пособие по API JavaScript Fetch: GET, POST, обработка ошибок и тайм-ауты

Учебное пособие по API JavaScript Fetch, протестированное на локальном сервере: GET и POST, почему не выдается ошибка 404, многоразовый помощник, ст…

Читать статью →
Разработка ПО

Обработка файлов Python: чтение, запись, CSV, JSON и pathlib с примерами

Обработка файлов Python объясняется с помощью кода, который мы запускали: открытые режимы, чтение больших файлов, CSV, JSON, pathlib, двоичные файлы…

Читать статью →
Разработка ПО

Классы и объекты Python: учебник ООП с реальными примерами

Классы и объекты Python, объясненные с помощью кода, который мы запускали: __init__, методы, атрибуты класса и экземпляра, наследование, свойства, м…

Читать статью →
Искусственный интеллект

Что такое большая языковая модель? Как работают LLM, объяснено без шумихи

Что такое большая языковая модель? LLM объясняется простым языком: токены, встраивания, внимание, обучение, температурные и контекстные окна, крошеч…

Читать статью →
DevOps

Команды Linux для начинающих: основное руководство по терминалу с примерами

Команды Linux для начинающих, сгруппированные по задачам: навигация, файлы, просмотр журналов, grep, каналы, разрешения, процессы и архивы, с практи…

Читать статью →
Автоматизация тестирования

Selenium vs Playwright: ключевые различия, сравнение кода и что выбрать

Сравнение Selenium и Playwright: архитектура, ожидание, поддержка браузера и языка, отладка, одинаковый тест в обоих инструментах, советы по миграци…

Читать статью →
Тестирование ПО

Разделение эквивалентности: метод проектирования тестов, объясненный на рабочих примерах

Объяснение эквивалентного разделения: как найти действительные и недействительные разделы, рабочие примеры для возрастов, паролей и купонов, проведе…

Читать статью →
Тестирование ПО

Серьезность и приоритет в тестировании программного обеспечения: различия, матрица и реальные примеры

Объяснение серьезности и приоритета при тестировании программного обеспечения: четкие определения, четырехсторонняя матрица с примерами, шкалы уровн…

Читать статью →
Базы данных и SQL

Учебное пособие по подзапросам SQL: типы, коррелирующие подзапросы и EXISTS с примерами

Руководство по подзапросам SQL с выполненными нами запросами: скалярные подзапросы, IN, FROM и SELECT, коррелированные подзапросы, EXISTS, ловушка N…

Читать статью →
Базы данных и SQL

Объяснение транзакций SQL и ACID: COMMIT, ROLLBACK и уровни изоляции

Транзакции SQL и ACID, объясненные с помощью банковского перевода, который мы выполнили: COMMIT, ROLLBACK, точки сохранения, блокировки, уровни изол…

Читать статью →
Разработка ПО

Git Commands Cheat Sheet: The Commands You Actually Use, With Examples

Шпаргалка по командам Git, сгруппированная по задачам: настройка, промежуточный этап, ветки, удаленные устройства, тайник, история и исправление оши…

Читать статью →
Разработка ПО

Объяснение промисов в JavaScript: then, catch, Promise.all и распространенные ошибки

Обещания JavaScript, объясненные с помощью кода, который мы запускали: состояния, цепочки then и catch, обработка ошибок, Promise.all, allSettled, R…

Читать статью →
Разработка ПО

Учебное пособие по словарю Python: методы, примеры и общие шаблоны

Учебное пособие по словарю Python с кодом, который мы выполнили: создание, чтение и обновление словарей, ключевые методы, слияние, понимание, шаблон…

Читать статью →
Искусственный интеллект

Что такое РАГ? Генерация с расширенным поиском, объясненная на рабочем примере

Что такое РАГ? Retrieval-augmented generation explained step by step: indexing, chunking, embeddings, retrieval, a small working Python example, eva…

Читать статью →
DevOps

Учебное пособие по Terraform для начинающих: инфраструктура как код от первого файла до модулей

Учебное пособие по Terraform для начинающих: начните без облачной учетной записи, изучите инициализацию, планирование и применение, затем переменные…

Читать статью →
DevOps

Docker и Kubernetes: ключевые различия, как они работают вместе и что вам нужно

Объяснение Docker и Kubernetes: что делает каждый из них, одно и то же приложение работает с обоими, сравнение Docker Compose и Swarm, изменение doc…

Читать статью →
Автоматизация тестирования

Учебное пособие по Pytest для начинающих: фикстуры, параметризация и реальные примеры

Учебное пособие по pytest для начинающих с тестами, которые мы запускали на pytest 9.2: утверждения, фикстуры, параметризация, conftest, маркеры, tm…

Читать статью →
Тестирование ПО

Жизненный цикл тестирования программного обеспечения (STLC): 6 этапов, критерии входа и выхода, пример

Объясняется жизненный цикл тестирования программного обеспечения: шесть этапов STLC с критериями входа и выхода, результаты, пример проработанной фу…

Читать статью →
Разработка ПО

Git merge vs rebase: отличия, примеры и когда что использовать

Git merge vs rebase с реальным выводом log, сравнительной таблицей, золотым правилом rebase и безопасным рабочим процессом для команды.

Читать статью →
Разработка ПО

Генераторы списков в Python: синтаксис, примеры и когда их избегать

Генераторы списков в Python: синтаксис, фильтры, if-else, вложенные циклы, измеренное время и случаи, когда обычный цикл for лучше.

Читать статью →
Базы данных и SQL

SQL JOIN: объяснение с примерами (Inner, Left, Right, Full)

Разберите SQL JOIN шаг за шагом на примерах таблиц и запросов: INNER, LEFT, RIGHT, FULL, CROSS и SELF, а также частые ошибки и советы по производите…

Читать статью →