idempotency_key_reuse


Kód	`idempotency_key_reuse`
Stavový kód HTTP	`409 Conflict`
Lze opakovat	Přečtěte si hodnotu `retryable` v odpovědi

Zvolte správný postup obnovy

Stejný chybový kód popisuje dvě různé situace. Před dalším postupem zkontrolujte retryable; samotný stavový kód HTTP neurčuje, zda má být požadavek opakován.

Odpověď	Význam	Další krok
`retryable: false`	Klíč již identifikuje požadavek s odlišným vstupem.	Porovnejte tělo požadavku s původním požadavkem. Nový klíč použijte pouze pro záměrně odlišnou operaci.
`retryable: true`	Jiný požadavek používající tento klíč se stále zpracovává.	Ponechte stejný klíč i požadavek. Počkejte alespoň `Retry-After` s a poté opakujte požadavek v rámci omezeného časového limitu.

Odlišný vstup

{
  "type": "https://docs.livingsecurity.com/developers/v1/errors/idempotency_key_reuse",
  "title": "Conflict",
  "status": 409,
  "detail": "Idempotency-Key was already used with a different request.",
  "code": "idempotency_key_reuse",
  "request_id": "req_0199a1e0-7c00-7000-8000-000000000001",
  "doc_url": "https://docs.livingsecurity.com/developers/v1/errors/idempotency_key_reuse",
  "retryable": false,
  "param": "Idempotency-Key"
}

Požadavek se stále zpracovává

Tento příklad obsahuje také hlavičku odpovědi HTTP Retry-After: 1.

{
  "type": "https://docs.livingsecurity.com/developers/v1/errors/idempotency_key_reuse",
  "title": "Conflict",
  "status": 409,
  "detail": "A concurrent request is still processing this Idempotency-Key. Retry shortly.",
  "code": "idempotency_key_reuse",
  "request_id": "req_0199a1e0-7c00-7000-8000-000000000001",
  "doc_url": "https://docs.livingsecurity.com/developers/v1/errors/idempotency_key_reuse",
  "retryable": true,
  "param": "Idempotency-Key"
}

Zachování stabilní identity opakování

U operací, které idempotenci dokumentují, je klíč vázán na organizaci, servisní účet, metodu HTTP, cestu k prostředku a vyhodnocenou verzi API. Změna kteréhokoli z těchto prvků vytvoří jinou identitu opakování; původní operaci tím neobnovíte. Rotace přihlašovacích údajů v rámci stejného servisního účtu tuto identitu nemění, nicméně nové přihlašovací údaje musí mít i nadále příslušné oprávnění. Při obnově po vypršení časového limitu zachovejte původní klíč, tělo požadavku, cestu i verzi. Nevytvářejte nový klíč jen proto, abyste konflikt obešli: původní zápis už mohl být úspěšně dokončen. Pokud znáte ID prostředku, načtěte jej a použijte zdokumentovaný postup obnovy dané operace. Dokončená opakovaná odpověď obsahuje Idempotent-Replayed: true, pokud operace opakování odpovědi dokumentuje. Odeslání hlavičky Idempotency-Key nezajistí, že bude operace idempotentní, pokud její reference tuto hlavičku výslovně nepodporuje. Ochrana proti opakování je omezena zásadami uchovávání dané operace; nepředstavuje trvalou záruku proti duplicitám. Pokud zpracování zůstává nevyřešeno, kontaktujte podporu Living Security a uveďte request_id, časový údaj v UTC, metodu, cestu a verzi API. Nikdy neuvádějte klíč API, tajný klíč klienta ani přístupový token.

Centrum pro vývojáře

Veřejné API v1

Reference API v1

Zvolte správný postup obnovy

Odlišný vstup

Požadavek se stále zpracovává

Zachování stabilní identity opakování

Centrum pro vývojáře

Veřejné API v1

Reference API v1

​Zvolte správný postup obnovy

​Odlišný vstup

​Požadavek se stále zpracovává

​Zachování stabilní identity opakování

Zvolte správný postup obnovy

Odlišný vstup

Požadavek se stále zpracovává

Zachování stabilní identity opakování