Idempotence (Idempotency)

Příklady z praxe

1. 01

   Platba s idempotenčním klíčem

   E-shop pošle platební bráně požadavek s hlavičkou obsahující identifikátor objednávky. Když se odpověď ztratí a e-shop požadavek zopakuje, brána podle klíče pozná, že tuhle platbu už provedla, a nestrhne peníze podruhé.

   Idempotency-Key: order-2026-07-27-8841

Časté omyly

MýtusIdempotentní znamená, že se při opakování nic nezmění.

Ve skutečnostiPrvní volání stav změnit může a obvykle změní. Idempotence říká, že každé další volání se stejnými vstupy už výsledný stav nezmění, ne že jej nezmění ani to první.

Časté dotazy

Je metoda POST idempotentní?

Podle specifikace HTTP idempotentní není. Zopakování požadavku POST může vytvořit další zdroj, proto se u plateb a objednávek doplňuje idempotenčním klíčem. Metody GET, PUT a DELETE jsou naopak podle specifikace idempotentní.

Jaký je rozdíl mezi idempotentní a bezpečnou metodou?

Bezpečná metoda stav vůbec nemění, typicky GET. Idempotentní metoda stav změnit může, ale opakované provedení už výsledek dál neposouvá. Každá bezpečná metoda je tedy idempotentní, opačně to neplatí.

Zdroje

1. RFC 9110, oddíl 9.2.2: Idempotent Methods(otevře se v novém okně)IETF, 2022

Související pojmy

• APIAPI je smluvené rozhraní, přes které spolu dva programy komunikují, aniž by jeden musel znát vnitřní fungování druhého. Definuje, jaké operace lze volat, jaká data se posílají a co se vrátí zpět.
• 3-D Secure3-D Secure je protokol, který u online platby kartou ověří, že platí skutečně její držitel, typicky potvrzením v bankovní aplikaci. Při úspěšném ověření se zároveň přenáší odpovědnost za podvodnou transakci z obchodníka na vydavatele karty.
• Platební bránaPlatební brána je služba, která propojuje e-shop nebo aplikaci s kartovými schématy, bankami a dalšími platebními metodami, aby bezpečně přijala a potvrdila platbu zákazníka. Obchodníkovi zprostředkuje autorizaci, ověření, návrat výsledku do objednávky a často i podklady pro refundace, párování a účetní vyrovnání.
• Opakovaná platbaOpakovaná platba je platební režim, při kterém zákazník předem souhlasí s tím, že obchodník může v budoucnu strhávat další částky podle sjednaných pravidel. Používá se pro předplatné, členství, splátky nebo automatické dobíjení kreditu. Technicky obvykle stojí na tokenu platební metody, ne na ukládání čísla karty.
• REST APIREST API je způsob návrhu webového rozhraní, kde klient pracuje se zdroji přes jednotné HTTP operace a server vrací jejich reprezentace, typicky ve formátu JSON. Důraz klade na jednoznačné adresy, bezstavovou komunikaci, cachování a oddělení klienta od serveru, ne na konkrétní knihovnu ani protokol navíc.
• Objednávkový procesObjednávkový proces je sled kroků, který převádí nákupní záměr zákazníka na potvrzenou, zaplacenou a vyřízenou objednávku. V e-commerce zahrnuje košík, checkout, výběr dopravy a platby, validaci údajů, rezervaci zásob, potvrzení, fakturaci, komunikaci se skladem a řešení výjimek, například zamítnuté platby nebo změny adresy.
• WebhookWebhook je způsob, jak aplikace automaticky oznámí jiné aplikaci událost pomocí HTTP požadavku na předem zadanou adresu. Místo průběžného dotazování odešle zdrojový systém zprávu ve chvíli, kdy se něco stane, například po zaplacení objednávky, změně stavu úlohy nebo vytvoření záznamu.
• Konfigurační managementKonfigurační management je disciplína, která udržuje nastavení serverů, aplikací a jejich verzí v definovaném, zdokumentovaném a opakovatelně obnovitelném stavu. Zahrnuje evidenci konfiguračních položek, řízení změn a nástroje jako Ansible, Puppet nebo Chef, které skutečný stav systému automaticky srovnávají s popisem uloženým ve verzovacím systému.