Wyjaśnienie webhooków: Jak działają i jak bezpiecznie je odbierać
Webhooki pozwalają jednemu systemowi informować inny o chwili wystąpienia zdarzenia, wysyłając żądanie HTTP na wybrany adres URL. Dowiedz się, czym różnią się one od odpytywania, jak weryfikować podpisy i jak przetrwać ponowne próby i powtórki za pomocą uruchomionego przez nas odbiornika.
- Webhooki to żądania HTTP POST wysyłane przez dostawcę na Twój adres URL w przypadku wystąpienia zdarzenia, dzięki czemu nie musisz ciągle pytać.
- Każdy może wywołać publiczny adres URL, więc sprawdź podpis HMAC w surowej treści, porównując w stałym czasie.
- Odrzuć stare znaczniki czasu, aby zatrzymać powtórki, i przechowuj identyfikatory zdarzeń, aby ponowione dostawy były przetwarzane tylko raz.
- W naszym przypadku odbiorca zaakceptował prawidłowe zdarzenie, zignorował jego ponowną próbę i odrzucił zmodyfikowane ciało, błędny sekret i 10-minutową powtórkę.
Twoja aplikacja musi wiedzieć, kiedy płatność się powiodła, zakończyła się kompilacja lub przesłano formularz w innej usłudze. Możesz co minutę zadawać tej usłudze pytanie: „coś nowego?”, ale większość odpowiedzi brzmiałaby „nie”. Webhooki odwracają kierunek: podajesz usłudze adres URL, a ona dzwoni do Ciebie w momencie wystąpienia zdarzenia.
Aby przetestować pomysły, a nie tylko je opisać, napisaliśmy mały odbiornik i nadawca webhooka ze standardową biblioteką Pythona 3.13, uruchomiliśmy oba na jednym komputerze i wystrzeliliśmy do niego prawidłowe, zmodyfikowane, powtórzone i ponawiane żądania. Poniższe wyniki zostały skopiowane z tego przebiegu. Jeśli interfejsy API w ogóle są dla Ciebie nowe, najpierw przeczytaj co to jest interfejs API.
Co to jest webhook?
Webhook to wywołanie zwrotne HTTP. Rejestrujesz punkt końcowy, taki jak https://example.com/hooks/payments, u dostawcy i wybierasz, na których zdarzeniach Ci zależy. Gdy tak się stanie, dostawca wysyła żądanie POST na ten adres URL z treścią JSON opisującą zdarzenie. Twój serwer odczytuje go, sprawdza, czy jest autentyczny, wykonuje swoją pracę i odpowiada kodem stanu 2xx.
Ludzie czasami nazywają webhooki „odwrotnymi interfejsami API”. W przypadku normalnego wywołania API Twój kod pyta, a dostawca odpowiada. Za pomocą webhooka dostawca rozpoczyna rozmowę.
Webhooki a ankiety
| Aspekt | Odpytywanie interfejsu API | Haki internetowe |
|---|---|---|
| Kto zaczyna | Twoja aplikacja na timerze | Dostawca na każdym wydarzeniu |
| Opóźnienie | Do jednego interwału odpytywania | Zwykle sekundy |
| Zmarnowane rozmowy | Wiele pustych odpowiedzi | Prawie żaden |
| Twój serwer potrzebuje | Tylko dostęp wychodzący | Publiczny punkt końcowy HTTPS |
| Przegapione wydarzenia | Rzadkie; pytasz ponownie | Możliwe w przypadku wyczerpania się liczby prób |
Jak wyjaśnia nasz przewodnik dotyczący ograniczania szybkości interfejsu API, odpytywanie pozwala również na przekroczenie limitów szybkości. Wiele zespołów korzysta z obu elementów: webhooków w celu zwiększenia szybkości oraz okresowej kontroli, która wychwytuje wszystko, co zostało przeoczone w przypadku nieudanej dostawy.
Jak działa dostarczanie webhooka
- U dostawcy ma miejsce zdarzenie, takie jak
payment.succeeded. - Dostawca tworzy ładunek JSON, podpisuje go tajemnicą udostępnioną tylko Tobie i wysyła go na Twój adres URL.
- Twój punkt końcowy weryfikuje podpis i sygnaturę czasową, rejestruje identyfikator zdarzenia i szybko zwraca 200.
- Jeśli Twój punkt końcowy ulegnie awarii lub przekroczy limit czasu, dostawca spróbuje ponownie później, zwykle z rosnącymi przerwami.
Jak wygląda ładunek
POST /hook HTTP/1.1
Content-Type: application/json
X-Timestamp: 1794500000
X-Signature: b82128c3c09fb40a...
{"id": "evt_1", "type": "payment.succeeded", "amount": 500}
Powyższe wartości sygnatury czasowej i podpisu są skróconymi ilustracjami. Nazwy nagłówków różnią się w zależności od dostawcy, ale większość wysyła identyfikator zdarzenia, typ zdarzenia, znacznik czasu i podpis. Nasz przewodnik po Pythonie JSON omawia bezpieczne analizowanie treści.
Podpisywanie i weryfikacja wniosków
Twój adres URL webhooka jest publiczny, więc każdy, kto się o nim dowie, może wysłać fałszywe zdarzenia, takie jak fałszywe „płatność powiodła się”. Standardową obroną jest podpis HMAC. Dostawca oblicza SHA-256 HMAC znacznika czasu i nieprzetworzonej treści, korzystając ze wspólnego sekretu, a Ty przeliczasz go po swojej stronie:
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)
Liczą się trzy szczegóły:
- Użyj surowych bajtów treści. Jeśli framework najpierw analizuje i ponownie serializuje JSON, odstępy lub kolejność kluczy mogą się zmienić, a podpis nie będzie zgodny.
- Porównaj w stałym czasie.
hmac.compare_digestzajmuje tyle samo czasu, niezależnie od tego, czy pierwszy, czy ostatni znak się różni, co eliminuje ataki czasowe. Zwykły==może zatrzymać się przy pierwszym niedopasowaniu. - Trzymaj sekret poza kodem. Przechowuj go w zmiennych środowiskowych lub menedżerze kluczy tajnych i zmieniaj go, jeśli wycieknie.
Wyniki naszych testów
Uruchomiliśmy odbiornik na porcie lokalnym i wysłaliśmy sześć rodzajów żądań:
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']
W przypadku naruszonej obudowy podpisaliśmy ciało za pomocą "amount": 500, a następnie zmieniliśmy je na 5000 w transporcie. Podpis nie był już zgodny, więc prośba została odrzucona. Podpis złożony z odgadniętym sekretem zawiódł w ten sam sposób. W sumie przetworzono tylko dwa zdarzenia, mimo że napłynęło więcej żądań. Kody stanu mają normalne znaczenie protokołu HTTP, zgodnie z naszą ściągawką dotyczącą kodów stanu HTTP.
Ochrona przed powtórkami
Prawidłowy podpis potwierdza, że dostawca utworzył żądanie, ale nie potwierdza, że jest ono świeże. Osoba atakująca, która przechwyci jedno prawdziwe żądanie, może wysłać je ponownie później. Uwzględnienie znacznika czasu w podpisanych danych i odrzucenie wszystkiego, co jest starsze niż kilka minut, zamyka tę lukę. Nasza 10-minutowa prośba została odrzucona, zanim w ogóle sprawdzono jej podpis. Synchronizuj zegary serwera, w przeciwnym razie oryginalne zdarzenia również mogą zostać odrzucone.
Wskazówka: rejestruj przyczynę każdego odrzuconego webhooka, ale nigdy nie rejestruj tajnego ani pełnego podpisu. Dzienniki odrzuceń pozwalają zauważyć błędnie skonfigurowany klucz tajny po rotacji.
Ponawia próbę z wycofaniem
Dostawcy ponawiają próbę w przypadku awarii punktu końcowego, przekroczenia limitu czasu lub zwrócenia stanu innego niż 2xx. Przeprowadziliśmy symulację punktu końcowego, który dwukrotnie uległ awarii przed odzyskaniem, a nadawca czekał dłużej między każdą próbą:
attempt 1: 500 temporarily down
attempt 2: 500 temporarily down
attempt 3: 200 ok
delivered: True
Nasz nadawca za każdym razem podwajał czas oczekiwania (50, 100, a następnie 200 milisekund). Prawdziwi dostawcy korzystają z tego samego pomysłu przez minuty i godziny, często przez dzień lub dłużej, a następnie poddają się i mogą wyłączyć punkt końcowy. Zwracaj 4xx tylko w przypadku żądań, których nigdy nie zaakceptujesz, takich jak złe podpisy, ponieważ niektórzy dostawcy przestają ponawiać próby w przypadku błędów klienta.
Idempotencja: przetwarzanie każdego zdarzenia raz
Ponowne próby oznaczają, że otrzymasz niektóre zdarzenia więcej niż raz, na przykład gdy serwer przetworzył zdarzenie, ale odpowiedź została utracona. Twój moduł obsługi musi być idempotentny: dwukrotna obsługa tego samego zdarzenia musi mieć taki sam efekt, jak jednorazowa obsługa. Zapisaliśmy identyfikator każdego zdarzenia i na powtórzenia odpowiadaliśmy „zignorowano duplikat”. W środowisku produkcyjnym identyfikatory należy przechowywać w tabeli bazy danych z unikalnym ograniczeniem, aby nie mogły się prześlizgnąć dwie równoległe dostawy.
Odpowiadaj szybko, pracuj później
Dostawcy czekają tylko kilka sekund na Twoją odpowiedź. Jeśli Twój moduł obsługi wysyła e-maile, wywołuje inne interfejsy API lub uruchamia raporty, wykonaj tę czynność po udzieleniu odpowiedzi: zweryfikuj, zapisz zdarzenie w kolejce lub tabeli, zwróć 200, a następnie przetwórz je w zadaniu w tle. Zapobiega to przekroczeniu limitu czasu dostaw i pozwala uniknąć burzy ponownych prób w wolnym okresie. Zdarzenia mogą również pojawiać się w niewłaściwej kolejności, dlatego należy sprawdzić bieżący stan obiektu, zamiast zakładać, że każde zdarzenie jest najnowsze.
Jak testować webhooki
- Przetestuj jednostkowo weryfikator ze znaną treścią, sygnaturą czasową i oczekiwanym podpisem, a także skrzynkami zmienionymi i wygasłymi.
- Uruchom odbiornik lokalnie i wysyłaj podpisane żądania, tak jak to zrobiliśmy, lub użyj interfejsu wiersza polecenia dostawcy lub pulpitu nawigacyjnego, aby wysłać zdarzenia testowe.
- Użyj narzędzia do tunelowania, aby odsłonić port lokalny, gdy dostawca musi połączyć się z Twoim laptopem; zamknij to później.
- Testuj duplikaty, zdarzenia poza kolejnością i powolne usługi podrzędne, a nie tylko szczęśliwą ścieżkę.
Narzędzia takie jak Postman mogą również wysyłać ręcznie tworzone żądania webhooka; zobacz nasze testy API z przewodnikiem Postman.
Lista kontrolna zabezpieczeń webhooków
- Akceptuj tylko HTTPS.
- Zweryfikuj podpis HMAC na surowym ciele, porównując w stałym czasie.
- Odrzucaj znaczniki czasu poza krótkim oknem.
- Przechowuj identyfikatory zdarzeń i ignoruj duplikaty.
- Zachowaj tajemnicę w konfiguracji, a nie w kodzie, i obsługuj rotację.
- Odpowiadaj szybko i przetwarzaj w tle.
- Traktuj ładunek jako niezaufane dane wejściowe; w razie wątpliwości pobierz najważniejsze szczegóły z interfejsu API dostawcy.
Podsumowanie
Webhooki są z pozoru proste, wystarczy HTTP POST, ale niezawodny odbiorca potrzebuje kilku przemyślanych nawyków. Nasze testy wykazały, że każdy z nich działa: podpisy przestały manipulować i fałszywych nadawców, znaczniki czasu uniemożliwiały powtórki, identyfikatory zdarzeń zatrzymywały podwójne przetwarzanie, a wycofywanie zapewniało dostawę nawet po krótkiej przerwie. Wbuduj je od pierwszej wersji, a webhook stanie się jedną z najbardziej niezawodnych integracji, jakie uruchamiasz.
Najczęstsze pytania
Czym w skrócie jest webhook?
Webhook to automatyczne żądanie HTTP wysyłane przez system na wybrany przez Ciebie adres URL w przypadku wystąpienia zdarzenia, np. pomyślnej realizacji płatności. Oszczędza to konieczności wielokrotnego odpytywania o zmiany.
Jaka jest różnica między webhookiem a interfejsem API?
W przypadku interfejsu API Twój kod prosi dostawcę o dane. Dzięki webhookowi dostawca wysyła dane do punktu końcowego, gdy coś się wydarzy. Wiele usług oferuje jedno i drugie.
Jak zweryfikować podpis webhooka?
Oblicz ponownie HMAC, zwykle SHA-256, na podstawie surowej treści żądania i sygnatury czasowej ze wspólnym sekretem, a następnie porównaj go z nagłówkiem za pomocą funkcji czasu stałego, takiej jak hmac.compare_digest.
Dlaczego dwukrotnie otrzymuję ten sam webhook?
Dostawcy ponawiają próbę, jeśli nie otrzymają odpowiedzi 2xx na czas, nawet jeśli zdarzenie zostało już przetworzone. Przechowuj identyfikatory zdarzeń i pomijaj duplikaty, aby obsługa pozostała idempotentna.
Jaki kod stanu powinien zwrócić punkt końcowy elementu webhook?
Szybko zwróć kod 2xx po zweryfikowaniu i zapisaniu zdarzenia. Zwróć 4xx w przypadku żądań, których nigdy nie zaakceptujesz, takich jak złe podpisy, i 5xx, jeśli chcesz, aby dostawca ponowił próbę.
Ucz się dalej
Potrzebujesz pomocy przy testowaniu, WordPressie lub SEO?
Pomagamy zespołom dostarczać lepsze oprogramowanie i rozwijać ich witryny. Powiedz nam, nad czym pracujesz, a my zaproponujemy jasny następny krok.
Więcej poradników na testowanie, sztuczna inteligencja i nowoczesny rozwój
Podobał Ci się ten artykuł? Wybierz temat i przejdź bezpośrednio do naszych najnowszych tutoriali.
Wyjaśnienie strategii fragmentowania RAG: stałe, nakładanie się, zdanie, rekurencyjne i nagłówki, mierzone
Strategie fragmentowania RAG porównane w jednym dokumencie z tiktokenem 0.14: stały rozmiar, nakładanie się, pakowanie zdań, dzielenie rekurencyjne …
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie tożsamości API: klucze idempotencji i bezpieczne ponowne próby, przetestowane
Wyjaśnienie idempotencji API na serwerze Python i kliencie, którego uruchomiliśmy: utracona odpowiedź spowodowała podwójną opłatę bez klucza i jedną…
Przeczytaj artykuł →DevOpsWyjaśnienie Git Stash: zapisywanie, stosowanie, otwieranie i nieśledzone pliki, testowane
Git stash wyjaśniono za pomocą poleceń, które uruchomiliśmy w Git 2.56: push z wiadomością, nieśledzone pliki, lista i pokaż, zastosuj vs pop, zacho…
Przeczytaj artykuł →Testowanie oprogramowaniaWyjaśnienie testowania parami: jak użycie wszystkich par zmniejsza 216 testów do 13, przetestowano
Testowanie w parach wyjaśnione za pomocą generatora uruchomionego w Pythonie 3.13: sprawdzenie z 216 kombinacjami objętymi 13 testami, zweryfikowany…
Przeczytaj artykuł →Automatyzacja testówWyjaśnienie testowania dubletów: atrapa, skrót, szpieg, próbna i fałszywa, z przetestowanym kodem Pythona
Testowanie dubletów wyjaśniono na jednym przykładzie Pythona uruchomionym w pytest 9.2: manekin, stub, szpieg, próbny i fałszywy, kiedy używać każde…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie SQL COALESCE: wartości domyślne, NULLIF, IFNULL vs ISNULL i pułapki, przetestowane
Wyjaśnienie SQL COALESCE za pomocą zapytań, które uruchomiliśmy w SQLite 3.50: pierwsze wartości inne niż null, puste ciągi znaków, NULL w matematyc…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie samodzielnego łączenia SQL: menedżer pracowników, porównania par i wierszy, przetestowane
Samodzielne łączenie SQL wyjaśnione za pomocą zapytań, które uruchomiliśmy w SQLite 3.50: pracownik i menedżer, zarabiający więcej niż menedżer, uni…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie operatora rozprzestrzeniania JavaScript: rozprzestrzenianie a reszta, kopie i błędy, przetestowane
Operator rozprzestrzeniania JavaScript wyjaśniony kodem, który uruchomiliśmy w węźle 24: tablice, obiekty, płytkie kopie, parametry spoczynkowe, lim…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie modułu kolekcji Pythona: licznik, defaultdict, deque i więcej, przetestowane
Kolekcje Pythona wyjaśnione za pomocą kodu, który uruchomiliśmy w Pythonie 3.13: Counter, defaultdict, deque, Nametuple, OrderedDict i ChainMap, a t…
Przeczytaj artykuł →Sztuczna inteligencjaWyjaśnienie okna kontekstowego LLM: tokeny, limity i sposób dopasowania większej ilości, zmierzone
Okno kontekstowe LLM wyjaśnione za pomocą liczby tokenów, które zmierzyliśmy za pomocą tiktokena: słowa kontra tokeny dla prozy, kodu i języka hindi…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie webhooków: jak działają i jak je bezpiecznie odbierać
Wyjaśnienie webhooków z odbiorcą i nadawcą, które uruchomiliśmy w Pythonie: push a odpytywanie, podpisy HMAC-SHA256, odrzucanie zmodyfikowanych i od…
Przeczytaj artykuł →DevOpsWyjaśnienie Git Cherry-Pick: Skopiuj potrzebne zatwierdzenie, bezpiecznie i przetestowane
Git cherry-pick wyjaśniono za pomocą poleceń, które uruchomiliśmy w Git 2.56: kopiowanie poprawki do gałęzi wydania, nowe skróty i identyfikatory po…
Przeczytaj artykuł →Automatyzacja testówWyjaśnienie testów migawkowych: jak to działa, kiedy pomaga, a kiedy szkodzi
Testowanie migawek wyjaśnione za pomocą pytestu i syropowego demo, które przeprowadziliśmy: tworzenie migawek, odczytywanie różnic po zmianie kodu, …
Przeczytaj artykuł →Testowanie oprogramowaniaWyjaśnienie testów mutacji: dlaczego 100% pokrycie nadal nie uwzględnia naszego błędu
Testowanie mutacji wyjaśniono za pomocą małego narzędzia mutacji, które zbudowaliśmy i uruchomiliśmy: 14 mutantów, zestaw testów ze 100% pokryciem l…
Przeczytaj artykuł →Sztuczna inteligencjaWyjaśnienie szybkiego wstrzyknięcia: jak oszukać aplikacje AI i jak się przed nimi bronić
Wyjaśnienie szybkiego wstrzykiwania dla konstruktorów: ataki bezpośrednie i pośrednie, dlaczego zawodzą filtry słów kluczowych (nasz test zablokował…
Przeczytaj artykuł →DevOpsWyjaśnienie rekordów DNS: A, AAAA, CNAME, MX, TXT i TTL z rzeczywistymi wyszukiwaniami
Rekordy DNS wyjaśnione na podstawie wyszukiwań, które przeprowadziliśmy: jak działa rozdzielczość, A i AAAA, reguły CNAME, MX i null MX, TXT dla SPF…
Przeczytaj artykuł →DevOpsWyjaśnienie flag funkcji: bezpieczne wydania, stopniowe wdrażanie i higiena flag
Flagi funkcji wyjaśnione za pomocą przeprowadzonej przez nas symulacji wdrożenia: typy flag, procentowe wdrożenia ze stabilnym mieszaniem, przełączn…
Przeczytaj artykuł →Automatyzacja testówTestuj generowanie danych za pomocą Python Faker: realistyczne, powtarzalne i bezpieczne dane
Przetestuj generowanie danych za pomocą Python Faker, uruchom i zmierz: zaszczepianie powtarzalnych danych, ustawień regionalnych, unikalnych wartoś…
Przeczytaj artykuł →Testowanie oprogramowaniaWyjaśnienie testowania z Shift-Left: Znajdź błędy wcześniej, bez spowalniania zespołu
Wyjaśniono testowanie z przesunięciem w lewo: co to znaczy, dlaczego wczesne defekty są tańsze, praktyki – od przeglądów wymagań po kontrole CI, zmi…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie funkcji ciągów SQL: TRIM, SUBSTR, REPLACE, CONCAT i czyszczenie danych
Funkcje ciągów SQL wyjaśnione za pomocą zapytań, które wykonaliśmy: konkatenacja i NULL, TRIM, UPPER i LOWER, SUBSTR i INSTR, REPLACE, dopełnienie, …
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie wyzwalaczy SQL: wyzwalacze PRZED i PO, dzienniki audytu i pułapki
Wyzwalacze SQL wyjaśnione za pomocą wyzwalaczy, które uruchomiliśmy: PRZED vs PO, STARY i NOWY, dzienniki audytu, walidacja, aktualizacje zapasów, w…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie modułu Python JSON: zrzuty, ładowanie, typy niestandardowe i typowe błędy
Moduł Python JSON wyjaśniony za pomocą uruchomionego przez nas kodu: zrzuty i ładowanie, pliki, konwersje typów, daty i miejsca dziesiętne, niestand…
Przeczytaj artykuł →Tworzenie oprogramowaniaModuły ES a CommonJS: Jak działa import JavaScript w Node.js, przetestowano
Moduły ES i CommonJS wyjaśnione za pomocą kodu, który uruchomiliśmy w Node.js: składnia importu i eksportu, wymagania, powiązania na żywo, buforowan…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie wyrażenia regularnego w języku Python: wzorce, grupy, przewidywania i pułapki, przetestowane
Wyrażenie regularne w Pythonie wyjaśnione za pomocą wzorców, które uruchomiliśmy: wyszukiwanie vs dopasowanie, findall, grupy i nazwane grupy, zachł…
Przeczytaj artykuł →Sztuczna inteligencjaWyjaśnienie strukturalnych wyników LLM: uzyskiwanie niezawodnego formatu JSON z modeli AI
Ustrukturyzowane dane wyjściowe LLM wyjaśnione wraz z walidacją przeprowadzoną w Pydantic: tryb i schematy JSON, ograniczone dekodowanie, sposoby ps…
Przeczytaj artykuł →DevOpsWyjaśnienie kluczy SSH: jak działają, ssh-keygen, Ed25519 i bezpieczne nawyki
Klucze SSH wyjaśnione za pomocą wygenerowanych przez nas kluczy: klucze publiczne i prywatne, ssh-keygen, Ed25519 vs RSA, odciski palców, hasła, ssh…
Przeczytaj artykuł →DevOpsWyjaśnienie buforowania HTTP: kontrola pamięci podręcznej, odpowiedzi ETag i 304 z testem na żywo
Wyjaśnienie buforowania HTTP na małym serwerze, który prowadziliśmy: dyrektywy Cache-Control, maksymalny wiek, brak pamięci podręcznej vs brak sklep…
Przeczytaj artykuł →Automatyzacja testówWyjaśnienie testowania kontraktu API: wychwytuj istotne zmiany przed wysyłką
Testowanie kontraktu API wyjaśniono za pomocą przeprowadzonej przez nas kontroli schematu: czym jest kontrakt, kontrakty zorientowane na konsumenta,…
Przeczytaj artykuł →Testowanie oprogramowaniaWyjaśnienie testowania opartego na ryzyku: oceń ryzyko, zbuduj macierz i przetestuj, co jest ważne
Testowanie oparte na ryzyku wyjaśnione krok po kroku: identyfikacja ryzyka, prawdopodobieństwo punktacji i wpływ, budowanie matrycy ryzyka, mapowani…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie ograniczeń SQL: NOT NULL, UNIQUE, CHECK i OBCY KLUCZ, przetestowane
Ograniczenia SQL wyjaśnione za pomocą przeprowadzonych przez nas testów: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY i FOREIGN KEY, luki NULL, ustawie…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie funkcji daty SQL: dodawanie, porównywanie i grupowanie dat bez błędów
Funkcje daty SQL wyjaśnione za pomocą zapytań, które wykonaliśmy: dodawanie interwałów, niespodzianki na koniec miesiąca, różnice dat, pułapka BETWE…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie asyncio Pythona: asynchronizacja, oczekiwanie, zbieranie i grupa zadań z rzeczywistym czasem
Asyncio Pythona wyjaśnione za pomocą kodu, który zmierzyliśmy: współprogramy, oczekiwanie, zbieranie, grupa zadań, obsługa błędów, przekroczenia lim…
Przeczytaj artykuł →Tworzenie oprogramowaniaOdbicie a przepustnica w JavaScript: jak działają, kiedy używać każdego z nich, przetestowano
Debounce a przepustnica w JavaScript wyjaśnione z czasami, które zmierzyliśmy w Node.js: jak każdy z nich działa, proste implementacje, wywołania wi…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie menedżerów kontekstu Pythona: instrukcja with, biblioteka kontekstowa i rzeczywiste zastosowania
Menedżerowie kontekstu Pythona wyjaśnili za pomocą uruchomionego przez nas kodu: jak działa, __enter__ i __exit__, kontekstlib.contextmanager, tłumi…
Przeczytaj artykuł →Sztuczna inteligencjaWyjaśnienie temperatury i góry LLM: jak modele AI wybierają kolejne słowo
Temperatura LLM i top-p wyjaśnione za pomocą przeprowadzonej przez nas symulacji: w jaki sposób zmieniają się prawdopodobieństwa, co utrzymuje top-p…
Przeczytaj artykuł →DevOpsWyjaśnienie YAML: składnia, problem norweski i inne pułapki, które testowaliśmy
YAML wyjaśnił za pomocą testu parsera: podstawowa składnia, listy i mapy, problem Norwegii, wersje zamieniające się w zmiennoprzecinkowe, ósemkowe k…
Przeczytaj artykuł →DevOpsWyjaśnienie zadań Cron: składnia, prawdziwe harmonogramy i błędy, które je psują
Zadania Cron wyjaśnione za pomocą zweryfikowanych przez nas harmonogramów: pięć pól, operatory, prawdziwe przykłady, pułapka dnia miesiąca LUB dnia …
Przeczytaj artykuł →Sztuczna inteligencjaWyjaśnienie halucynacji AI: dlaczego modele językowe tworzą rzeczy i jak je zmniejszyć
Wyjaśniono halucynacje AI: czym są, dlaczego powstają w modelach językowych, typowe typy, jak je zredukować za pomocą uziemień i podpowiedzi oraz pr…
Przeczytaj artykuł →DevOpsWyjaśnienie zmiennych środowiskowych: pliki .env, sekrety i konfiguracja wykonana prawidłowo
Zmienne środowiskowe wyjaśnione na przykładach Pythona, które przeprowadziliśmy: ich odczytywanie i ustawianie, dlaczego każda wartość jest ciągiem …
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie ograniczenia szybkości interfejsu API: algorytmy, nagłówki i obsługa błędów 429
Ograniczanie szybkości API wyjaśnione za pomocą przeprowadzonej przez nas symulacji: zasobnik tokenów, stałe okno, przesuwane okno, 429 odpowiedzi, …
Przeczytaj artykuł →Automatyzacja testówWyśmiewanie w Pythonie: unittest.mock, patch i błędy, które sprawiają, że testy kłamią
Wyśmiewanie w Pythonie za pomocą unittest.mock, przetestowane: Mock i zwracana wartość, efekt uboczny, łatanie tam, gdzie używana jest nazwa, specyf…
Przeczytaj artykuł →Testowanie oprogramowaniaWyjaśnienie zasięgu kodu: pokrycie linii i oddziału oraz co naprawdę oznacza 100%
Wyjaśnienie pokrycia kodu za pomocą prawdziwego pliku cover.py: pokrycie linii, gałęzi i warunków, przeczytanie raportu, dlaczego 100% pokrycia może…
Przeczytaj artykuł →Bazy danych i SQLDELETE vs TRUNCATE vs DROP w SQL: różnice, wycofywanie i kiedy używać każdego z nich
DELETE vs TRUNCATE vs DROP wyjaśnione za pomocą przetestowanego SQL: co każdy usuwa, wycofywanie, wyzwalacze, resetowanie tożsamości, prędkość i czy…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie widoków SQL: tworzenie, używanie i unikanie pułapek wraz z przykładami
Widoki SQL wyjaśnione za pomocą zapytań, które uruchomiliśmy: tworzenie widoku, wyniki na żywo, ukrywanie kolumn, wydajność, widoki z możliwością ak…
Przeczytaj artykuł →Tworzenie oprogramowaniaInterfejs TypeScript a typ: rzeczywiste różnice, testowane za pomocą kompilatora
Interfejs TypeScript a typ, sprawdzony z prawdziwym kompilatorem: co oba mogą zrobić, co tylko jeden, łączenie deklaracji, rozszerzenia a przecięcia…
Przeczytaj artykuł →Tworzenie oprogramowaniaPython *args i **kwargs wyjaśnione: elastyczne funkcje z przejrzystymi przykładami
Python *args i **kwargs wyjaśnione za pomocą uruchomionego przez nas kodu: pakowanie i rozpakowywanie, kolejność parametrów, argumenty zawierające t…
Przeczytaj artykuł →Tworzenie oprogramowaniaFunkcje Lambda w Pythonie: składnia, rzeczywiste zastosowania i kiedy ich nie używać
Funkcje lambda w Pythonie wyjaśnione za pomocą uruchomionego przez nas kodu: składnia, sortowanie za pomocą klucza, mapa i filtr, domknięcia, pułapk…
Przeczytaj artykuł →Sztuczna inteligencjaKim są agenci AI? Jak one działają, dzięki prostej pętli agenta, którą możesz uruchomić
Kim są agenci AI? Prosty przewodnik po pętli agenta, narzędziach, pamięci i poręczach, z małą pętlą w Pythonie, którą uruchomiliśmy, prawdziwymi zag…
Przeczytaj artykuł →DevOpsMonitorowanie a obserwowalność: prawdziwa różnica z logami, wskaźnikami i śladami
Wyjaśnienie monitorowania a obserwowalności: znane i nieznane awarie, dzienniki, metryki i ślady, opis incydentu przy kasie, złote sygnały, OpenTele…
Przeczytaj artykuł →DevOpsWoluminy platformy Docker a mocowania powiązań: utrwalanie danych kontenera we właściwy sposób
Wyjaśniono woluminy Dockera a montowanie powiązań: dlaczego dane kontenera znikają, nazwane woluminy, montowanie powiązań, tmpfs, przykłady tworzeni…
Przeczytaj artykuł →Automatyzacja testówTDD vs BDD: kluczowe różnice, jedna funkcja zbudowana w obie strony i kiedy używać każdej z nich
TDD vs BDD wyjaśnione za pomocą jednej funkcji rabatowej zbudowanej w obie strony: refaktoryzacja czerwono-zielona z uruchomionym przez nas kodem, s…
Przeczytaj artykuł →Testowanie oprogramowaniaTestowanie akceptacyjne użytkownika (UAT): proces, lista kontrolna i rzeczywiste przykłady
Wyjaśniono testy akceptacyjne użytkownika: kto je przeprowadza, czym różni się od kontroli jakości, siedmioetapowy proces, szablon przypadku testowe…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie wartości SQL NULL: IS NULL, COALESCE, NULLIF i pułapki, których należy unikać
Wartości SQL NULL wyjaśnione za pomocą zapytań, które wykonaliśmy: logika trójwartościowa, IS NULL, COALESCE, NULLIF, w jaki sposób agregacje, łącze…
Przeczytaj artykuł →Bazy danych i SQLInstrukcja SQL CASE WHEN: składnia, rzeczywiste przykłady i typowe błędy
SQL CASE WHEN wyjaśnione za pomocą zapytań, które uruchomiliśmy: proste i przeszukiwane formularze, kolejność warunków, elementy przestawne z SUM, s…
Przeczytaj artykuł →Tworzenie oprogramowaniaCo to jest JWT? Tokeny internetowe JSON wyjaśnione na przykładzie działania
Co to jest JWT? Wyjaśniono tokeny sieciowe JSON: trzy części, token zbudowany i zmodyfikowany w uruchomionym przez nas kodzie, JWT a sesje, pamięć m…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie pętli zdarzeń JavaScript: stos wywołań, mikrozadania i liczniki czasu z przykładami
Pętla zdarzeń JavaScript wyjaśniona za pomocą uruchomionego przez nas kodu: stos wywołań, kolejki zadań i mikrozadań, dlaczego setTimeout 0 nie jest…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie generatorów Pythona i wydajności: oszczędzaj pamięć dzięki prawdziwym przykładom
Generatory Pythona i wydajność wyjaśnione za pomocą uruchomionego przez nas kodu: sposób wstrzymywania i wznawiania, mierzone oszczędności pamięci, …
Przeczytaj artykuł →Sztuczna inteligencjaCzym są osady? Wyjaśnienie wektorów i podobieństwa cosinusa
Czym są osadzania? Prosty przewodnik po wektorach, podobieństwie cosinusów i wyszukiwaniu semantycznym, z małym przykładem, który przeprowadziliśmy,…
Przeczytaj artykuł →DevOpsWdrożenie niebiesko-zielone a kanaryjskie: różnice, kompromisy i sposób wyboru
Wyjaśniono wdrożenie Blue-Green vs Canary: sposób działania każdego z nich, koszty, ryzyko i wycofywanie zmian, przetestowane przez nas stabilne łąc…
Przeczytaj artykuł →Automatyzacja testówNiestabilne testy: co je powoduje i jak je naprawić na dobre
Niestabilne testy wyjaśnione w przeprowadzonych przez nas demonstracjach: główne przyczyny, sposób potwierdzenia i zdiagnozowania jednej z nich, odp…
Przeczytaj artykuł →Testowanie oprogramowaniaLoad Testing vs Stress Testing: Differences, Metrics and k6 Examples
Wyjaśniono testy obciążenia i testy warunków skrajnych: co dowodzi każdy z nich, testy szczytowe i nasiąkania, istotne metryki, dlaczego średnie wpr…
Przeczytaj artykuł →Testowanie oprogramowaniaPrzypadek testowy a scenariusz testowy: kluczowe różnice, przykłady i kiedy stosować każdy z nich
Wyjaśnienie przypadków testowych i scenariuszy testowych: jasne definicje, tabela obok siebie, jedna funkcja resetowania hasła zaczerpnięta ze scena…
Przeczytaj artykuł →Bazy danych i SQLOptymalizacja zapytań SQL: czytaj plany wykonania i napraw powolne zapytania z synchronizacją
Optymalizacja zapytań SQL przetestowana na milionie wierszy: przeczytaj plany wykonania, dodaj odpowiednie indeksy, napraw filtry niesargowalne, uży…
Przeczytaj artykuł →Bazy danych i SQLSQL UNION vs UNION ALL: różnice, przykłady i testowana wydajność
SQL UNION vs UNION ALL wyjaśnione na podstawie zapytań, które uruchomiliśmy: duplikaty, obie reguły są zgodne, prawdziwy błąd danych, zmierzona wyda…
Przeczytaj artykuł →Tworzenie oprogramowaniaSamouczek API pobierania JavaScript: GET, POST, obsługa błędów i limity czasu
Samouczek JavaScript Fetch API testowany na serwerze lokalnym: GET i POST, dlaczego 404 nie rzuca, pomocnik wielokrotnego użytku, ciągi zapytań, prz…
Przeczytaj artykuł →Tworzenie oprogramowaniaObsługa plików w Pythonie: odczyt, zapis, CSV, JSON i pathlib z przykładami
Obsługa plików w Pythonie wyjaśniona za pomocą uruchomionego przez nas kodu: tryby otwarte, czytanie dużych plików, CSV, JSON, pathlib, pliki binarn…
Przeczytaj artykuł →Tworzenie oprogramowaniaKlasy i obiekty Pythona: samouczek OOP z prawdziwymi przykładami
Klasy i obiekty Pythona objaśnione za pomocą uruchomionego przez nas kodu: __init__, metody, atrybuty klas i instancji, dziedziczenie, właściwości, …
Przeczytaj artykuł →Sztuczna inteligencjaCo to jest model dużego języka? Jak działają LLM, wyjaśnione bez szumu
Co to jest model dużego języka? LLM wyjaśnione prostym językiem: tokeny, osadzanie, uwaga, szkolenie, temperatura i okna kontekstowe, mała demonstra…
Przeczytaj artykuł →DevOpsPolecenia systemu Linux dla początkujących: niezbędny przewodnik po terminalu z przykładami
Polecenia systemu Linux dla początkujących, pogrupowane według zadań: nawigacja, pliki, przeglądanie logów, grep, potoki, uprawnienia, procesy i arc…
Przeczytaj artykuł →Automatyzacja testówSelenium kontra dramaturg: kluczowe różnice, porównanie kodu i wybór
Porównanie Selenium i Playwright: architektura, oczekiwanie, obsługa przeglądarki i języka, debugowanie, ten sam test w obu narzędziach, porady doty…
Przeczytaj artykuł →Testowanie oprogramowaniaPartycjonowanie równoważne: technika projektowania testów wyjaśniona na praktycznych przykładach
Wyjaśniono podział równoważny: jak znaleźć prawidłowe i nieprawidłowe partycje, sprawdzone przykłady dla grup wiekowych, hasła i kupony, przeprowadz…
Przeczytaj artykuł →Testowanie oprogramowaniaWażność a priorytet w testowaniu oprogramowania: różnice, macierz i rzeczywiste przykłady
Wyjaśniono ważność a priorytet w testowaniu oprogramowania: jasne definicje, czterokierunkowa macierz z przykładami, skale poziomów, kto ustawia każ…
Przeczytaj artykuł →Bazy danych i SQLSamouczek dotyczący podzapytań SQL: typy, skorelowane podzapytania i ISTNIEJĄ z przykładami
Samouczek dotyczący podzapytań SQL z zapytaniami, które wykonaliśmy: podzapytania skalarne, IN, FROM i SELECT, podzapytania skorelowane, EXISTS, puł…
Przeczytaj artykuł →Bazy danych i SQLWyjaśnienie transakcji SQL i ACID: COMMIT, ROLLBACK i poziomy izolacji
Transakcje SQL i ACID wyjaśnione za pomocą wykonanego przez nas przelewu bankowego: COMMIT, ROLLBACK, punkty zapisu, blokady, poziomy izolacji, brud…
Przeczytaj artykuł →Tworzenie oprogramowaniaŚciągawka dotycząca poleceń Git: polecenia, których faktycznie używasz, z przykładami
Ściągawka poleceń Git pogrupowana według zadań: konfiguracja, przemieszczanie, gałęzie, piloty, skrytka, historia i cofanie błędów, z danymi wyjścio…
Przeczytaj artykuł →Tworzenie oprogramowaniaWyjaśnienie obietnic JavaScript: następnie catch, Promise.all i typowe błędy
Obietnice JavaScript wyjaśnione za pomocą uruchomionego przez nas kodu: stany, łańcuchy then i catch, obsługa błędów, Promise.all, allSettled, race …
Przeczytaj artykuł →Tworzenie oprogramowaniaSamouczek słownika języka Python: metody, przykłady i typowe wzorce
Samouczek słownika języka Python z uruchomionym przez nas kodem: tworzenie, odczytywanie i aktualizowanie słowników, metody kluczowych, łączenie, ro…
Przeczytaj artykuł →Sztuczna inteligencjaCo to jest RAG? Generacja rozszerzona o wyszukiwanie wyjaśniona na przykładzie roboczym
Co to jest RAG? Generowanie wspomagane pobieraniem wyjaśnione krok po kroku: indeksowanie, fragmentowanie, osadzanie, pobieranie, mały działający pr…
Przeczytaj artykuł →DevOpsSamouczek Terraform dla początkujących: Infrastruktura jako kod od pierwszego pliku do modułów
Samouczek Terraform dla początkujących: zacznij bez konta w chmurze, naucz się inicjowania, planowania i stosowania, a następnie zmiennych, wyników,…
Przeczytaj artykuł →DevOpsDocker kontra Kubernetes: kluczowe różnice, jak ze sobą współpracują i czego potrzebujesz
Wyjaśniono Docker vs Kubernetes: co robi każdy z nich, ta sama aplikacja działa z obydwoma, porównanie Docker Compose i Swarm, zmiana podkładki dock…
Przeczytaj artykuł →Automatyzacja testówSamouczek Pytest dla początkujących: urządzenia, parametryzacja i prawdziwe przykłady
Samouczek pytest dla początkujących z testami, które przeprowadziliśmy na pytest 9.2: asercje, urządzenia, parametryzacja, conftest, znaczniki, tmp_…
Przeczytaj artykuł →Testowanie oprogramowaniaCykl życia testowania oprogramowania (STLC): 6 faz, kryteria wejścia i wyjścia, przykład
Wyjaśniono cykl życia testowania oprogramowania: sześć faz STLC z kryteriami wejścia i wyjścia, elementy dostarczane, działający przykład funkcji lo…
Przeczytaj artykuł →Tworzenie oprogramowaniaGit merge vs rebase: różnice, przykłady i kiedy czego używać
Git merge vs rebase wyjaśnione na prawdziwym wyniku logu, z tabelą porównawczą, złotą zasadą rebase i bezpiecznym procesem pracy zespołu.
Przeczytaj artykuł →Tworzenie oprogramowaniaPython list comprehension: składnia, przykłady i kiedy jej unikać
Python list comprehension wyjaśnione: składnia, filtrowanie, if-else, zagnieżdżone pętle, zmierzone czasy i sytuacje, w których zwykła pętla for jes…
Przeczytaj artykuł →Bazy danych i SQLSQL JOIN – wyjaśnienie z przykładami (Inner, Left, Right, Full)
Zrozum złączenia SQL krok po kroku na przykładowych tabelach i zapytaniach: INNER, LEFT, RIGHT, FULL, CROSS i SELF, plus typowe błędy i wskazówki wy…
Przeczytaj artykuł →