Příručka
Idempotence
Opakovaný požadavek se stejným klíčem nic nezaloží podruhé.
Pro novou operaci vygenerujte UUID a uložte ho s úlohou ve svém systému. Při opakování požadavku použijte uloženou hodnotu. Proměnnou nastavte také pro PHP příklady:
export FAKTURANET_IDEMPOTENCY_KEY="$(uuidgen)"
- Každý POST musí mít hlavičku
Idempotency-Keys 16–128 znaky z písmen, číslic a._:-, nejlépe UUID v4. Pro každou novou operaci vygenerujte nový klíč. - Když spojení spadne a nevíte, jestli operace proběhla, pošlete stejný požadavek se stejným klíčem znovu. Dostanete původní výsledek a nic se nezaloží podruhé.
- Stejný klíč s jinými daty vrátí
idempotency-key-reused. - API si klíč pamatuje 30 dní. Opakujte proto operaci se stejným klíčem jen v této době.
- PATCH a DELETE hlavičku Idempotency-Key nepotřebují. Opakované DELETE již smazaného záznamu může vrátit 404.