idempotency_key_reuse


Cod	`idempotency_key_reuse`
Stare HTTP	`409 Conflict`
Se poate reîncerca	Citiți `retryable` din răspuns

Alegeți corect modul de recuperare

Același cod de eroare descrie două situații diferite. Verificați retryable înainte de a acționa; starea HTTP singură nu indică dacă trebuie să reîncercați.

Răspuns	Semnificație	Pasul următor
`retryable: false`	Cheia identifică deja o solicitare cu date de intrare diferite.	Comparați corpul cererii cu solicitarea inițială. Utilizați o cheie nouă doar pentru o operațiune diferită în mod intenționat.
`retryable: true`	O altă solicitare care utilizează cheia este încă în curs de procesare.	Păstrați aceeași cheie și aceeași solicitare. Așteptați cel puțin `Retry-After` secunde, apoi reîncercați într-un interval de timp limitat.

Date de intrare diferite

{
  "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"
}

Solicitare încă în curs de procesare

Acest exemplu include și antetul de răspuns 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"
}

Păstrați stabilă identitatea de reîncercare

Pentru operațiunile care documentează idempotența, cheia este limitată la organizație, contul de serviciu, metoda HTTP, calea resursei și versiunea API rezolvată. Modificarea oricăreia dintre acestea creează o altă identitate de reîncercare; nu recuperează operațiunea inițială. Rotirea unei credențiale în cadrul aceluiași cont de serviciu nu schimbă această identitate, deși credențiala de înlocuire trebuie să aibă în continuare permisiunea necesară. Păstrați cheia, corpul cererii, calea și versiunea inițiale când vă recuperați după o depășire a timpului de așteptare. Nu generați o cheie nouă doar pentru a depăși un conflict: scrierea inițială poate fi deja finalizată cu succes. Preluați resursa atunci când îi cunoașteți ID-ul și utilizați procedura de recuperare documentată a operațiunii. O reluare finalizată conține Idempotent-Replayed: true acolo unde operațiunea documentează reluarea răspunsului. Trimiterea unui Idempotency-Key nu face o operațiune idempotentă decât dacă documentația sa acceptă explicit acel antet. Protecția la reîncercare este limitată de politica de păstrare a operațiunii; nu reprezintă o garanție permanentă împotriva duplicatelor. Dacă procesarea rămâne nerezolvată, contactați asistența Living Security și furnizați request_id, marcajul temporal UTC, metoda, calea și versiunea API. Nu includeți niciodată o cheie API, un secret de client sau un token de acces.

Hub pentru dezvoltatori

API public v1

Referință API v1

Alegeți corect modul de recuperare

Date de intrare diferite

Solicitare încă în curs de procesare

Păstrați stabilă identitatea de reîncercare

Hub pentru dezvoltatori

API public v1

Referință API v1

​Alegeți corect modul de recuperare

​Date de intrare diferite

​Solicitare încă în curs de procesare

​Păstrați stabilă identitatea de reîncercare

Alegeți corect modul de recuperare

Date de intrare diferite

Solicitare încă în curs de procesare

Păstrați stabilă identitatea de reîncercare