Přejít na obsah
FakturanetAPI v1.0.0
OpenAPI API klíče

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-Key s 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.

Hledat v dokumentaci

Hledejte endpoint, pole, objekt, typ chyby nebo téma příručky.