idempotency_key_reuse


Koodi	`idempotency_key_reuse`
HTTP-tila	`409 Conflict`
Uudelleenyritettävissä	Lue `retryable` vastauksesta

Valitse oikea palautumistapa

Sama virhekoodi kuvaa kahta eri tilannetta. Tarkista retryable ennen toimenpiteisiin ryhtymistä; pelkkä HTTP-tila ei kerro, pitääkö pyyntö yrittää uudelleen.

Vastaus	Merkitys	Seuraava vaihe
`retryable: false`	Avain tunnistaa jo pyynnön, jonka syöte on erilainen.	Vertaa pyynnön runkoa alkuperäiseen pyyntöön. Käytä uutta avainta vain, jos operaatio on tarkoituksella eri.
`retryable: true`	Toinen samaa avainta käyttävä pyyntö on edelleen käsiteltävänä.	Säilytä sama avain ja sama pyyntö. Odota vähintään `Retry-After` sekuntia ja yritä sitten uudelleen rajatun aikabudjetin puitteissa.

Eri syöte

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

Pyyntö on edelleen käsiteltävänä

Tässä esimerkissä on myös HTTP-vastausotsikko 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"
}

Pidä uudelleenyrityksen tunniste muuttumattomana

Niiden operaatioiden osalta, joiden dokumentaatiossa kuvataan idempotenssi, avain on rajattu organisaatioon, palvelutiliin, HTTP-metodiin, resurssipolkuun ja selvitettyyn API-versioon. Minkä tahansa näistä muuttaminen luo eri uudelleenyrityksen tunnisteen, eikä se palauta alkuperäistä operaatiota. Tunnistetietojen vaihtaminen saman palvelutilin alla ei muuta tätä tunnistetta, vaikka korvaavalla tunnistetiedolla on edelleen oltava käyttöoikeus. Säilytä alkuperäinen avain, runko, polku ja versio, kun palaudut aikakatkaisusta. Älä luo uutta avainta pelkästään ristiriidan ohittamiseksi: alkuperäinen kirjoitus on saattanut jo onnistua. Hae resurssi, kun sen tunnus on tiedossa, ja noudata operaation dokumentoitua palautumismenettelyä. Valmistunut uusinta sisältää Idempotent-Replayed: true, kun operaation dokumentaatiossa kuvataan vastauksen uusinta. Idempotency-Key -otsikon lähettäminen ei tee operaatiosta idempotenttia, ellei operaation viitedokumentaatiossa nimenomaisesti todeta kyseisen otsikon tukea. Uudelleenyritysten suoja on rajattu operaation säilytyskäytännön mukaan; se ei ole pysyvä takuu kaksoiskappaleita vastaan. Jos käsittely pysyy ratkaisematta, ota yhteyttä Living Securityn tukeen ja ilmoita request_id, UTC-aikaleima, metodi, polku ja API-versio. Älä koskaan liitä mukaan API-avainta, asiakassalaisuutta (client secret) tai käyttöoikeustunnusta (access token).

Kehittäjäkeskus

Julkinen rajapinta v1

API v1 -viite

Valitse oikea palautumistapa

Eri syöte

Pyyntö on edelleen käsiteltävänä

Pidä uudelleenyrityksen tunniste muuttumattomana

Kehittäjäkeskus

Julkinen rajapinta v1

API v1 -viite

​Valitse oikea palautumistapa

​Eri syöte

​Pyyntö on edelleen käsiteltävänä

​Pidä uudelleenyrityksen tunniste muuttumattomana

Valitse oikea palautumistapa

Eri syöte

Pyyntö on edelleen käsiteltävänä

Pidä uudelleenyrityksen tunniste muuttumattomana